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PREFACE 


The utilization of each MSX-BASIC command and function is explained 
in this manual. Also, additional explanations that cover several groups 
of commands are provided in a separate chapter with actual examples. 
Please use this manual to learn MSX-BASIC or for actual MSX-BASIC 
programming. 


This manual is intended for use with Sony MSX system only. 
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CHAPTER 1 








COMMANDS, FUNCTIONS, 
SPECIAL VARIABLES AND 
FUNCTIONS, AND ERROR 
MESSAGES 





1-1 COMMANDS AND FUNCTIONS 


In this chapter, MSX-BASIC commands and functions are explained in an 
alphabetical sequence. 


INTRODUCTORY REMARKS 





Command, function name 









seg 


PSET (point set) 


Seas 









































Puts a dot on the graphic screen. ———— Function 





& 
: 











FORMAT 
Format 
[PSET [STEP] (X-coordinate, Y-coordinate) [, color]| 
X-coordinate, Y-coordinate Numerical constants, variables, array 


variables and their expressions from 
— 32768 to 32767. 











Color Integers from 0 to 15. Input condition 
QD [Current foreground color 











When input is omitted 


FUNCTION AND UTILIZATION 





Supplementary command and function explanations, and execu- 
tion examples in which commands and functions are utilized. 

















is written in front of the function 


In regard to a function, jaytereaden, 
name. os 





(example) 









































ABS (absolute) __ 


Input item omission 
An input item inside [ ] in the FORMAT section can be omitted. 


For 
SCREEN [Mode], [Sprite size], [Key click switch], [Baud rate], [Printer type], 
when only the mode and sprite size are specified, it is as follows. 


SCREEN 2,3 ee ; 
Items after this, including commas, canbe omitted. 


When only the printer type is specified, it is as follows. 


SCREEN ,,,,1 
palcb ieee 


Input item repetition 


DATA Constant [, Constant] ..... 


As many constants as desired can be repeated after DATA within the in- 
put range per line. 





ABS absolute) - 


Gives the absolute value for numeric data. 








FORMAT 


ABS(X) 

X Numberic constants, variables, array variables, and their expres- 
sions. 

Given value: Numeric type 


FUNCTION AND UTILIZATION 
Gives X when X = O and —X when X < 0. 


Execution example 


PRINT ABS (2) 
2 


PRINT ABS (3-10) 
7 


ASC (esci 


Gives the character code for the first character of string data. 











FORMAT 


ASC(X$) 


X$ String constants, variables, array variables, and their expres- 
sions. 


Given value: Single-precision integers, decimal expressions. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT ASC("d”) 
100 ———YM—Character code of “d”. 


PRINT ASC ("data”) 
100 —————————Character code of “d”. 








FORMAT 
ATN(X) 
X Numeric constants, variables, array variables, and their expres- 
sions. 
Given value: Numeric type 


FUNCTION AND UTILIZATION 

The ATN function gives a floating-point type numeric value which indi- 
cates an angle in which the value of the trigonometric function, tan, is 
X. Its unit is a radian. 

@To obtain the result in degree units, multiply by 180/z. 


Execution example 


PRINT ATN(1) 
- 785398 16339745 —————— Unit is radians. 


PRINT ATN(1)*180/3.14159 
45 .0000380093905——————— Unit is degrees. 








Line numbers are automatically generated from a specified line number 
with a specified increment. 





FORMAT 
AUTO [starting line number] [, increment] 
Starting line number An integer from 0 to 65529. 
ind 0. However if “, increment” is omitted, it is 10. 
Increment GEER integers from 1 to 65529. 
Guy 10. 


FUNCTION AND UTILIZATION 

Used to eliminate the keying in of line numbers while entering a program. 
@When a program statement exists for a generated line number, “ * ” ap- 
pears on the right of the line number. To modify this program statement, 
move the cursor to “ * ”, then input a new statement after deleting “ * ” 
with a space. When no modification is required, press [RETURN |. 

@To stop automatic line number generation, press |STOP| while press- 
ing |CTRL| or press |c} while pressing [CTRL]. 























Execution example 


AUTO 100,50 
100 PRINT 712345” 
150* 

nN 





Indicates that line number 150 exists. 





B EEP (beep 


A beep sound occurs. 


i ae 








FORMAT 
BEEP 


FUNCTION AND UTILIZATION 


Execution example 
£0 FOR f[=0 [0 9 


20 BEEP 
30 NEXT I 


This program generates a beep sound 10 times continuously. 





BINS (binary dollar) 


Gives a binary expression of numeric data as string type data. 





FORMAT 


BIN$(X) 

X Numeric constants, variables, array variables, and their expres- 
sions from —32768 to 65535. For a negative number, it has the same 
value as if its value was added to 65536. 

Given Value: String type 


FUNCTION AND UTILIZATION 


Execution example 


PRINT BIN$S(100) 
1100100 


PRINT BINS (-32768) 
1000000000000000 












usraaara a nuta a 
2 
o 


oe 





FORMAT 


BLOAD “device name [file name]” [,R] [, offset] 

Device name CAS: ... Cassette tape 

File name String within 6 characters. If 7 or more characters are 

specified, the 7th character and after are ignored. 

(nD Loads the file which was found first. 

R option GD Load only. 

Offset Integers from —32768 to 65535. 
GD 0 


FUNCTION AND UTILIZATION 

Loads a machine language program saved by a BSAVE statement at an 
address between the starting address and an end address specified by 
a BSAVE statement. If offset is specified, the value is added to the start- 
ing address and end address. 

elf‘ R” is specified, the program is executed after load termination. At 
that time, the execution start address is an address specified by a BSAVE 
statement. 





FORMAT 
BSAVE “device name [file name]’, starting address, end address [, exe- 
cution start address] 
Device name CAS: ..Cassette tape 
File name String within 6 characters. If 7 or more characters are 
specified, the seventh character and after are ignored. 

GHD Null string. 

Starting address, end address 
Integers from - 32768 to 65535. 

Execution start address 
Integers from - 32768 to 65535. 
@inns Considered as a starting address. 


FUNCTION AND UTILIZATION 

Saves the content within a memory range from a starting address to an 
end address with binary code which is used for saving machine 
language. 

@|f an execution start address is specified, execution starts from the ad- 
dress specified when the machine language program was loaded by a 
BLOAD statement with an R option. If omitted, the starting address is 
considered as an execution start address. 


Execution example 


BSAVE ”“CAS:PROG4” ,&HEOOO , &XHE8OO , XHELOO 









Be CALL cai)! 


Executes an extended command of a ROM cartridge. 


es 





FORMAT AND FUNCTION 
CALL extended command [(argument, argument ...)] 
Argument Integer constants, variables, array variables, and their expres- 
sions. Character constants, variables, array variables, and 
their expressions. 


When an extended command is provided by a ROM cartridge, it can be 
executed by a CALL statement. 
@_ (underline) can be utilized instead of a character CALL. 





Converts numeric data to double precision data. 





FORMAT 
CDBL(X) 
X Numeric constants, variables, array variables, or their expres- 
sions. 
Given value: Double precision numeric type 


FUNCTION AND UTILIZATION 
Given numerical data is internally treated as double precision data by the 
CDBL function. 


——a 
PSE HHeHeEEEHERHEEEEEEEEEEEEE & B 






Function | CH R$ (character dollar) 


Gives the character of a specified character code. 





FORMAT 
CHRS$(X) 
X Numeric constants, variables, array variables, and their expres- 
sions from 0 to 255. 
Given value: String type 


FUNCTION AND UTILIZATION 


Execution example 


PRINT CHRS$(100) 
d 


See the character code table (page 186). 





CINT (convert to integer) 


Converts numeric data to integer type data. 





FORMAT 


CINT(X) 

X Numerical constants, variables, array variables, and their expres- 
sions from — 32768 and less than 32768. 

Given value: Integer type 


FUNCTION AND UTILIZATION 

When numeric data X is an integer value, it is maintained as it is. When 
it is a floating point type value, it is converted to an integer value by omit- 
ting values below the decimal point. It differs from the INT function in 
that the INT function gives the whole number out of X while CINT con- 
verts X to an integer in which the internal processing is different. 


Execution example 


PRINT CINT (9/2) 
4 


PRINT CINT (12k200*55) 
Over f low 








Pe CIRCLE (circle) a 


Draws a circle, oval, a part of a circular arc or a fan shape on the fore- 
ground in the graphic mode. 





FORMAT 
CIRCLE [STEP] (central coordinate), radius, [color], [start angle], [end 
angle], [aspect ratio] 
Central X-coordinate, central Y-coordinate 
Numerical constants, variables, array variables, their ex- 
pressions from — 32768 to 32767. 


Radius Numerical constants, variables, array variables, their ex- 
pressions from — 32768 to 32767. 
Color Integers from 0 to 15. 


(MND Current foreground color 
Start angle From —2z to 2x (unit is radians). 
Gy 0 
End angle From —2z to 2x (unit is radians). 
Gh 27 
Aspect ratio Positive numerical constants, variables, array variables, 
their expressions. 


Gi 1 


FUNCTION AND UTILIZATION 

Draws acircle with a specified radius and with specified coordinates as 
its center. When a start angle and end angle are specified, only a part of 
a circular arc is drawn. A fan shape can be drawn by placing—(minus) 
for the start angle and end angle. An oval can be drawn with an aspect 
ratio by specifying the power of the vertical radius for the horizontal 
radius. 

@See page 154 for STEP specifications. 


Execution example 


10 CLS 

20 SCREEN 2 

30 CIRCLE (50,50),30,,,,4 

40 CIRCLE STEP(70,70) ,30,,,,5.25 
50 GOTO SO 


efi BPBoHHHeHRHHEHHHEHEEeEEeEEeEBHEEBEH B F_. 

















Note 


If the aspect ratio is omitted, an oval is drawn. To display a circle, specify 
1.4 as the aspect ratio. 



































C L EAR (clear) 










































































Initializes all variables and sets the size of the character area and the 
highest memory address used in BASIC. Also, closes all open files, if any. 






— 


FORMAT 
CLEAR [size of character area] [, highest address] 
Size of character area Numeric constants, variables, array variables, 
their expressions. 

Gi Current set value (initial state is 200). However, 
the character area size cannot be independent- 
ly omitted. 

Highest address Numerical constants, variables, array varia- 
bles, their expressions. 

Gin Current set value. 





FUNCTION AND UTILIZATION 


Execution example 


CLEAR 400,55296 


All variables are initialized by this statement. Also, the size of the charac- 
ter string area is set to 400 bytes and the highest address of the BASIC 
program area is set to 55296. 








FORMAT 


CLOAD [“file name’] 


File name String within 6 characters. If 7 or more characters are speci- 
fied, the seventh character and after are ignored. 
(ind Loads the first program file found. 


FUNCTION AND UTILIZATION 


Execution example 


ve v7 Loads the program with the file name PROG1 from 
CLOAD ”“PROG1 cassette tape to memory 


@When an error occurs during load, rewind the tape to reload it. 


Ce CLOAD? (cassette load verify) 





Compares a program saved on cassette tape with one in memory. 





FORMAT 
CLOAD? [‘‘file name”] 
File name String within 6 characters. If 7 or more characters are speci- 
fied, the seventh character and after are ignored. 
@innd Compares the first program file found with one in memory. 


FUNCTION AND UTILIZATION 
A command that checks if a program is correctly saved or not. When it 


is executed, the program in memory is compared with a program saved 
on cassette tape with a specified file name. 

@ After comparison shows that the programs match, OK is displayed and 
input wait occurs. When they do not match, “Device I/O error” is dis- 
played and input wait occurs. 

@ lf the file name is omitted or CLOAD? “\_,” is input, the first program 


file found on a tape is compared with the program in memory. (_u means 
a space.) 


Execution example 
CLOAD? ”PROG1” 


ne CLOSE (close 


Closes a file which was opened by an OPEN statement. 








FORMAT 
CLOSE [#] [file number] [, file number]..... 
File number 1<file numbersnumeral specified by MAXFILES =state- 
ment 
(WD Closes all the files. 


FUNCTION AND UTILIZATION 


Execution example 


10 MAXFILES=3 

20 SCREEN 2 

30 OPEN ”“GRP:” FOR OUTPUT AS #1——Opens file 1 

40 OPEN ”“GRP:” FOR OUTPUT AS #2—— Opens file 2 

50 OPEN ”GRP:” FOR OUTPUT AS #3——Opens file 3 

60 PRINT #1.”ABC” 

70 PRINT #2, ”DEF” 

80 PRINT #3,”GHI” 

100 CLOSE ———--C los es alll the files. 


eet area C LS (clear screen) 


Erases all displays on the screen. 








FORMAT 
CLS 


@In the graphic mode, the background color is changed by executing 
CLS after specifying it with a COLOR statement. 








SE eAne ne 


Specifies the color of the foreground, background, and border area. 





FORMAT 


COLOR [foreground color], [background color], [border color] 
Foreground color, background color, border color 
Integers from 0 to 15. (See the color table below.) 
@nu Current color 


Color code table 
Code Color Code Color Code Color Code Color 


O | Transparent 4  |Dark blue 8 |Medium red; 12 | Dark green 
i Black 5 |Light blue; 9 |Light red 13. | Magenta 
2 |Medium green| 6. |Dark red 10 |Dark yellow | 14 | Gray 

3 |Light green 7 |Sky blue 11. |Light yellow} 15 | White 






































FUNCTION AND UTILIZATION 


Execution example 


COLOR 6 Only the foreground color (character color in text tnode, 
and graphics color in graphic mode) is changed. 


COLOR ,2 ——\Only the background color is changed. 





COLOR ,,11- 


Only the border area color is changed. 


COLOR 15,4 ,4 ——————Initialized. 


@See page 150 for the screen configuration. 

@ln the graphic mode, the background color is not changed by only 
specifying the background color with a COLOR statement but is changed 
only after executing CLS. 


2] co NT (continue) 


Restarts a program. 








FORMAT 
CONT 


FUNCTION AND UTILIZATION 

Restarts a program that was interrupted by [ctrt] + [stop] or by a 
STOP statement in a program. When a CONT statement is executed, exe- 
cution starts from the statement next to the interrupted statement. 
However, if an interrupt occurred during the execution of an INPUT state- 
ment, execution starts from the beginning of the statement. 

















FORMAT 


COS(X) 

X Numeric type constants, variables, array variables, their expres- 
sions. (Unit is radians.) 

Given value: Floating-point type constants from —1 to 1. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT COS (3.14/3) 
-90045968900814 


PRINT COS (60*3.14/180) 
. 900459689008 14 


@ To give X in degree units, use the formula COS (X * 7/180). 





CSNG (convert to single precision) 


Converts numeric data to single precision data. 








FORMAT 
CSNG(X) 
xX Numeric type constants, variables, array variables, their expres- 


sions. 
Given value: Single-precision type. 


FUNCTION AND UTILIZATION 


Execution exampie 


10 PRINT SQR (3) 
20 PRINT CSNG(SQR (3) ) 
RUN 
1.7320508075688 
1.73205 


ae CSAVE (cassette save 





Saves an MSX-BASIC program file on cassette tape. 











FORMAT 
CSAVE “file name” [, baud rate] 
File name String within 6 characters. If 7 or more characters are 
specified, the seventh character and after are ignored. 
Baud rate 1 (1200 baud) or 2 (2400 baud). 
Gi 1 (1200 baud) 


FUNCTION AND UTILIZATION 

Although up to 6 characters can be used for a file name, a numeral can 
not be used at the beginning. As for the baud rate, when 1 is specified, 
the baud rate is 1200 baud, and when 2 is specified, it is 2400 baud. 


Execution example 


Saves a BASIC program in memory to cassette 
22 Pe ~ 
E> CSAVE “PROG tape with a file name “PROG1”. 















cre nU NEUEN enuNeEN Om uNDeENER 

se eee rnenimeeas 

eee 
FORMAT 
CSRLIN 


FUNCTION AND UTILIZATION 


Execution example 


10 CLS 

20 INPUT AS 

30 PRINT AS; 

40 CL=CSRLIN 

50 LOCATE 0,CL+3:PRINT “END” 


The character data displayed by line 30 occupies only one line or plural 
lines depending its length. However, the Y-coordinate (vertical location) 
of the cursor after display is input to variable CL and “END” is displayed 
with a value which is greater than CL by 3 as the Y-coordinate. Therefore 
“END” is displayed 3-lines below notwithstanding the A$ data length. 





GE DATA cata 


Gives data read by a READ statement. 








FORMAT 
DATA constant [, constant] ..... 
Constant Numeric or string type. 


FUNCTION AND UTILIZATION 

@When data items are arranged in one DATA statement, they are punctu- 
ated by a comma (, ). 

@\f data in a DATA statement sequentially matches variables in a READ 
statement, it can be located anywhere for a READ statement and as 
many DATA statements as desired can be utilized. 

@When string type data includes a comma (,) or colon (:), or when a 
space is inserted in front and at the back, it is placed inside double quo- 
tation marks (’’). 


Execution example 


10 CLS 

20 SCREEN 2 

30 READ A,B,C,D 

40 LINE (A,B)-(C,D) 
50 DATA 0,0,255,191 
60 GOTO 60 








= DEF FN (define function) | 


Defines a user function. 








FORMAT 


DEF FN function name [(parameter [, parameter] ..... )]=expression 

Function name Numeric type, string type variables (Type is in accord 
with the expression.) 

Parameter @aIrp Up to 9 variables. 

Expression Numeric type, string type constants, variables, array 
variables, their expressions. 


FUNCTION AND UTILIZATION 


Execution example 


10 DEF FNA(X,Y)=(Xx*2+Y*3) / (X-Y) 
20 B=FNA(4,2) 

30 PRINT B 

RUN 

7 


In line 10, the function FNA(X,Y) is defined as the following expression. 
in line 20, 4 and 2 are given as values for the X and Y parameter, then the 
function is called. The result, 7, is assigned to variable B. 





DEFINT 














define integer) 

















aes 


( 
DEFSNG (define single precision) 
DEFDBL (define double precision) 
DEFSTR 


define string) 


Defines the correspondence of the first character of the variable name 
and the variable type. 

(INT: Integer type, SNG: Single precision, DBL: Double precision, STR: 
String type.) 





FORMAT 
DEFINT character [—character] 
DEFSNG character [—character] 
DEFDBL character [—character] 
DEFSTR character [—character] 
Character One alphabetical character. 


FUNCTION AND UTILIZATION 
DEFINT A-C 


As a result, all the variables, starting with characters A, B and C, are in- 
teger type. 


Priority of type declaration characters (“%, !, #, $) 
After declaring DEFINT A, A becomes a double-precision variable by 
declaring A# later. 


Execution example 


10 DEFINT A-C ———— s ariables from A to C are integer type. 
20 A=1.23456789 

30 ABC=1.23456789 
40 BH=1.23456789 


— Variables A, ABC become integer type by line 10. 





Double-precision type by placing # 


50 C!=1.23456789 —— Single-precision type by placing ! 
60 PRINT A;ABC;B#;C! 
RUN 


1 1 1.23456789 1.23457 





Specifies a starting address of a machine language subroutine to be 
called by a USR function. 





a 


FORMAT 
DEFUSR [X]=starting address 
X Integers from 0 to 9. 
Oi 0 
Starting address Numeric type constants, variables, their expres- 
sions from 0 to 65535. 


FUNCTION AND UTILIZATION 
Execution example 


DEFUSR 1=&HEOOO 


As a result, a machine language subroutine which starts from address 
&HEOO0 is defined as USR1. 

@The starting address can be redefined as many times as required in 
one program without changing the value of user number (X). 


(See 2-8, Machine Language Subroutines.) 





Pee DELETE (delete) 





Erases a specified line in a program. 


oppure 





FORMAT 


DELETE [line number] [-line number] 
Line number Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 


Execution example 
DELETE 40 
DELETE 20-40 
DELETE -50 


DELETE. 


Erases line 40 


Erases lines from 20 to 40. 


Erases lines from the starting line to line 50. 


Erases a line displayed last by a LIST statement or 
a line that was interrupted due to an error. 


@When only one line is to be erased, input the line number only and 


press [RETURN |. 








FORMAT 


DIM variable name (maximum value of a subscript [, maximum value 
of a subscript] ...) [, variable name (_ ), ....] 
Variable Numeric or string type. 
Maximum value of a subscript 
Integer type constants, variables, array variables, and their ex- 
pressions over 0. 


FUNCTION AND UTILIZATION 


Execution example 
DIM A(15)- 


Sets up an area of 16 numeric type array variables from A(0) 
to A(15) in memory. The initial value of variables is 0. 





DIM B&(2,3): Sets up an area of 12 variables as shown below (string type). 
The initial value of variables is a null-string. 














B$(0,0) BS$(1,0) BS(2,0) 
BS(0,1) | BS(1,1) | BS(2,1) 
B$(0,2) BS(1,2) B$(2,2) 
BS(0,3) | BS(1,3) | BS(2,3) 

















To define a plural number of array variables by one DIM statement 
DIM A(2) ,B$(4,2) ,C(3.3) 
Each variable is punctuated with a comma. 


Multi-dimensional array variables 
Multi-dimensional array variables are generated by specifying 2 maxi- 
mum values or more for subscript. 


DIM X(3,4,5)————3 dimension 
DIM statement omission 


When an array variable is utilized without declaring a DIM statement, the 
maximum value of the subscript is consid 









D RAW (draw) : 


Draws graphics on the graphic screen as specified in graphic sub- 
commands. 


icicle 





FORMAT 


DRAW subcommand 

Subcommand Character string (constants) inside or string type 
variables in which a character string is assigned. Capi- 
tals or small characters. 


won 























Subcommands 
Command | Condition Semantics | 
Sn O0<n<255 | Specifies the number of dots for 1 unit when a 
(scale) line is drawn. 
1/4 dot with n=1. 
Initialization is S4. 
An Osns3 AQ Al 
(angle) Rotates coordinate x 
system by step of 90° 
for astandard coor- y Y 
dinate axis (0°). re 
Initialization is AO. Ae f a 
x x 
Cn Osnsi5 Specifies a color for a line drawn by a color code. 
(color) Initialization is C15. 
Mx, y 0<x<255 ae 
(move) Osys191 = 
Current point 
Draws a line froma 
Current point to an ab- 
solute location (x, y). & y) 
r 























Command 


Condition 


Semantics 





M+x, +y 
(move) 


Osx <255 
Osys191 


Shifts horizontally +x 
from a current point and 
+y vertically. The unit 
for x, y is the number of 
dots specified by the S 
subcommand. 








Draws a line toward a 
negative direction on 
the Y axis from a cur- 
rent point to another 
point by an n distance. 
The unit of n is the 
number of dots speci- 
fied by the S subcom- Current point 
mand. (1 if omitted.) Ne 


>< 








Dn 
(down) 


Draws a line toward a 
positive direction on the 
Y-axis from a current 
point to another point 
by an n distance. The 
unit for n is the number 
of dots specified by the 
S subcommanad. (1 if 
omitted.) YY 


Yx 





Current point 














Rn 
(right) 


Draws alineina 
positive direction on the 
X axis from the current 
point to another point 

by an n distance. The —., 
unit of n is. the number Current 

of dots specified by the point 

S subcommanad. (1 if 

omitted.) ¥ 


Yx 











Ln 
(left) 








Draws a lineina 
negative direction on 
the X-axis from the cur- 
rent point to another 

point by an n distance. —, 
The unit of nis the Current 
number of dots speci- point 
fied by the S subcom- 

mand. (1 if omitted.) Y 


Vx 














Command 


Condition 


Semantics 





En 


Draws a line ina 

positive direction on the - 
X-axis and in a negative 
direction on the Y-axis 
from the current point 

to another point by ann 
distance. The unit of n 

is the number of dots Current 
specified by the S sub- yy point 
command. (1 if omitted.) 











Fn 


Draws a line ina 
positive direction on the 
X-axis and ina positive Cuitent 
direction on the Y-axis point 
from a current point to 

another point by ann 

distance. The unit of n 

is the number of dots 

specified by the S sub- 
command. (1 if omitted.) 











Draws a line ina 
negative direction on 


Xx 





the X-axis and in a posi- 
tive direction on the Y- 
axis from a current 
point to another point 
by ann distance. The 
unit of n is the number 
of dots specified by the 
S subcommand. (1 if YY 
omitted). 





> 


Current 
point 














Draws a line ina 
negative direction on 





the X-axis andina 
negative direction on 
the Y-axis from a current 
point to another point 
by ann distance. The 
unit of n is the number 
of dots specified by the 
S subcommanad. (1 if YV 
omitted.) 





Yx 


Current 
point 








FUNCTION AND UTILIZATION 
The current locationis always stored with a command to draw a line ex- 
cept Sn, An, Cn. For example, 


DRAW ”“M100,120” 


When a line is drawn from a certain point to another point (100, 120) by 
the above message, then this point becomes the current point. Then, 
when a command to draw a line is made again, a line is drawn from this 
current point to a specified point. 

One of the following two commands can be placed in front of a com- 
mand to draw a line. 


B....Although the current point is shifted, a line is not drawn. 
(Example: BMO,0) 

N....Although a line is drawn, the current point is not shifted. 
(Example: NU30,30N R30,30) 


To express a subcommand with a variable 


A$S="BM100 , 1SOUSOESOFSOD50L 100” 
DRAW AS 


In this example, a Ssubcommand is assigned once toa string type variable 
A$, then A$ is specified as a subcommand in a DRAW statement. 


To express a part of 


AS="U20R20D20L 20” 
DRAW ”BMS50 ,50XA$;” 
DRAW ”*BM150,100XAS$;” 


When a subcommand assigned to a string type variable is used inside 
“ ” of a DRAW statement, add X before and “;” after that. In this example, 
a subcommand assigned to A$ is used in two DRAW statements. 


To express nin a subcommand with a variable (=variable;) 

n which expresses the shift distance, angle and color code with each 
subcommand can be a constant or a variable in a DRAW statement. 
When it is expressed with a variable, add = before and “;” after that. 


x=40 
DRAW “U=X;” 





is the same as 
DRAW ”U40” 


Execution example 


10 SCREEN 2 ———————G@raphic mode when a DRAW statement is used. 


20 DRAW ”BM125,100” 

30 FOR I=4 TO 240 STEP 12 
40 DRAW ”S=I1;BURD2L2U2RBD” 
50 NEXT I 

60 GOTO 60 


to (125, 100) without drawing anything. 


Continuously draws squares 
with different sizes. 































































































given. 





FORMAT 
EOF (file numer) 
File number 1<file number<numeral specified by MAXFILE=state- 
ment 
Given value: Integer type (—1 or 0) 


FUNCTION AND UTILIZATION 


IF EOF (1) THEN CLOSE #1 


When the last data is read while datais being read from the file whose 
file number is 1, a file is closed by the above statement. 








FORMAT 
END 


FUNCTION AND UTILIZATION 

The END statement is used in the last line of the main program when a 
subroutine is written after a main program to prevent a subroutine from 
being executed again after the main program is terminated. It can be 
used as many times as desired in one program such as when a program 
execution result is branched into some result. It can be used at the end 
of each branch. 

@A RUN or GOTO statement is used to execute it again. It cannot be re- 
sumed by a CONT statement. 


100 GOSUB 1000 


190 
200 END 
1000 *’ SUBROUTINE 


1100 RETURN 


In this program, if an END statement does not exist in line 200, the 
subroutine from line 1000 is entered without a GOSUB statement after 
returning from a subroutine and executing line 190, and an error occurs. 


zz ERAS E (erase) 


Erases an array variable. 








FORMAT 
ERASE array variable name [, array variable name] ..... 


FUNCTION AND UTILIZATION 


10 DIM A(100) ,BS(4,3) 


100 ERASE A,B$ 


In this example, array variables A and B$, declared in line 10, are erased 
in line 100. After this, the memory area can be used for another purpose. 
Also, an array variable with the same name can be redefined by a DIM 
statement. 


ERL (error line) 


Gives the line number of a line where an error occurred. 








FORMAT 
ERL 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 

When no error has occurred, 0 is given. When an error results from a 
direct command, 65535 is given. 

Is used by combining it with an ON ERROR statement or an ERROR 
statement. 





FORMAT 
ERR 
Given value: Integer type. 


FUNCTION AND UTILIZATION 

Can be used for error processing in a program by combining it with an 
ERROR statement or ERL function. 

@When no error occurs, 0 is given. 


Execution example 


PRINT 10/0 
Division by zero 
PRINT ERR 

11 








MR ERROR erron 


Simulates an error of a specified error number or defines an error 
number. 


| 


FORMAT 
ERROR error number 
Error number Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 


FUNCTION AND UTILIZATION 


ERROR 1 ———————Generates a NEXT without FOR error. 
(Stops program execution:) 


User definit 

IF A < 0 THEN ERROR 250 

When a negative numeral is assigned to variable A based on the above, 
error 250 occurs. (Since error numbers up to 59 are defined in MSX-BASIC, 
numbers larger than those shall be used.) 


Execution example 

When a negative numeral is input in the following program, a message 
is displayed that indicates a positive numeral is required, and program 
execution continues. 


10 ON ERROR GOTO 90 

20 FOR I=1 TO 10 

30 INPUT A 

40 IF A<O THEN ERROR 250 
50 SUM=SUM+A 

60 NEXT I 

70 PRINT SUM 

80 END 

90 IF ERR=250 THEN PRINT “Input a positi 
ve number .”:RESUME 30 
100 PRINT “Error!” 












_ 


FORMAT 
EXP(X) 
X Numeric type constants, variables, array variables, their expres- 
sions below 145.06286085862. 
Give in value: Floating-point type. 
@e (2.7182818284588) is the base of a natural logarithm. 


FUNCTION AND UTILIZATION 
Execution example 


PRINT EXP (100) 
2.6881171418087E+43 


FIX (is) 


Gives the integer of numeric data. 








FORMAT 


FIX(X) 

xX Numeric type constants, variables, array variables, their expres- 
sions. 

Given value: Numeric type. 


FUNCTION AND UTILIZATION 
Gives the value of numeric data X in which the figure below the decimal 
point is truncated. 


Execution example 


PRINT FIX(3) ;FIX(-3) sFIX(3.58) ;FIX(-3.58) 
3°=3, 3.43 





FO R—NEXT (for—next) : 


Repeats program execution between a FOR statement and a correspond- 
ing NEXT statement. 





FORMAT 
FOR variable=initial value TO end value [STEP increment] 


NEXT [variable] 
Variable Numeric type. FOR statement variables shall be the same 
as those in the NEXT statement. 
Initial value, end value 
Numeric type constants, variables, and their expressions. 
Increment Numeric type constants, variables, their expressions. 
Gp 1 


FUNCTION AND UTILIZATION 

A program between a FOR statement and a NEXT statement is repeated- 
ly executed while the value of the variable specified in the FOR state- 
ment is increased from an initial value to an end value. The value of the 
variable is increased by aspecified amount each time program execution 
is terminated. 

@ Although the variable in the NEXT statement can be omitted, the cor- 
respondence between FOR and NEXT can be easily understood in a pro- 
gram list if it is written. 


Execution example 


10 FOR I=10 TO 50 STEP 10 
20 PRINT “I="31 
30 NEXT I 


This program is executed as follows. 











Execution transfers to the statement 
after the NEXT statement. 















Executes statements between the FOR 
and NEXT statements 


seeteees Add 10 to variable |. 





Multi-loop 

A FOR—NEXT loop can be placed inside a FOR—NEXT loop. In this 
case, the inner loop must be completely included inside the outer loop. 
A different variable is used for each loop. 


10 FOR I=1 TO 5 


20 FOR J=1 TO I 
30 PRINT ”X”; a Inner loop 
Outer loop 


40 NEXT J 
50 PRINT 
60 NEXT I 


Several FOR statements can be terminated by one NEXT statement. In 
this case, the variable name cannot be omitted in the NEXT statement. 
Variables are arranged sequentially with the inner loop first by punctuat- 
ing them with commas. 


FOR I=0 TO 10 


FOR J=0O TO 5 


NEXT JoI 














































































4 ee FRE (tree) | 


_ 





























Gives the number of bytes in an unused area of memory which can be 
used in MSX-BASIC. 





FORMAT 
FRE(X) 
FRE(“ ”) 
X Arbitrary numeric value. 
Given value: Integer type. 


FUNCTION AND UTILIZATION 


PRINT FRE(0)- Displays the number of bytes in an unused 
area of memory. 


PRINT FRE (””)-=: Displays the number of bytes in an unused part 
of a character string area in memory. 








iGOSUB—RETURN (go to subroutine—return) | 


Transfers execution to a specified subroutine. The RETURN statement in- 
dicates the end of the subroutine in which execution is returned to a lo- 
cation next to GOSUB or to a specified line numer. 





_ 


FORMAT 
GOSUB line number 





RETURN [line numer] 
Line number @i~p Integers from 0 to 65529. 
@ine When omitted in a RETURN statement, it is the line num- 
ber next to the GOSUB statement. 


FUNCTION AND UTILIZATION 


\ 


100 GOSUB 1000 Mainroutlie 





200 GOSUB 1000 a ——__ Subroutine 


>». OF 


300 GOSUB 1000 


1000 ° SUBROUTINE 











1100 RETURN J Calls one subroutine by a plural 
3 number of GOSUB statements. 


100 GOSUB 1000 


Main routine 














7 Subroutine 
200 GOSUB 2000 100 mae 
i 1100 
1000 * SUBROUTINE 1 Subroutine 
: ea 200 ——>Ja0—~S 
1100 RETURN | 
‘ [zo | 
2000 * SUBROUTINE 2 — 


A plural number of subroutines are 
placed in one program. 


2100 RETURN 


100 GOSUB 1000 


1000 * SUBROUTINE 1 


Main routine 


Subroutine 


1050 GOSUB 2000 ° Tt | a 


1100 RETURN 








2000 ; SUBROUTINE 2 Calls another subroutine from one subroutine. 
, (GOSUB statement multiplexing) 


2100 RETURN 


GOSUB statement multiplexing performance depends on the existing 
memory. 









— 





: GOTO (go toy 


a 





FORMAT 
GOTO line number 
Line number Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 

Program execution is transferred to a line specified by a GOTO 
statement. 

@When executed in the direct command mode, execution starts froma 
specified line. 

















FORMAT 


HEX$(X) 
X Numeric type constants, variables, array variables, their expres- 
sions from — 32768 to 65535. In the case of negative numerals, their 
value is the same as if it is added to 65536. 
Given value: String type. 


FUNCTION AND UTILIZATION 


PRINT HEX$(100) 
64 


PRINT HEX$ (-32768) 
8000 


PRINT HEX$(255) 
FF 





# 


| F—THEN—ELSE (it—then—eise) | 


Branches execution according to the value of an expression. 





FORMAT 
IF expression THEN statement [ELSE statement] 
Expression @ard A relational expression for which the result becomes 


a numeric expression, logical expression, or arithmet- 
ic expression. 

ELSE statement @iii® To the statement after THEN if the expression value is 
true, and to the next line if it is false. 


FUNCTION AND UTILIZATION 

If the value of an expression is true (except 0), the statement after THEN 
is executed and if the value of an expression is false (0), the statement 
after ELSE is executed. Then execution is transferred to the next line. 

@When the ELSE statement is omitted, the statement after THEN is ex- 
ecuted if the expression value is true. If it is false, the statement after 
THEN is ignored and execution is transferred to the next line. 

@in the |F—THEN GOTO format, THEN or GOTO can be omitted. 

IF A=0 THEN 30 -~Same meaning 

IF A=0 GOTO 30 : 

The statement or line number comes after THEN. 

the line number comes after GOTO. 

@When the GOTO statement comes after ELSE, GOTO can be omitted. 
@When a plural number of statements are written after THEN or ELSE, 
they are executed sequentially with the left statement first. Statements 
shall be punctuated with a colon (:). 





Execution example 


10 INPUT A 

20 IF A>=0 THEN PRINT “ABS=";A ELSE PRIN 
T “ABS="5-A 

30 GOTO 10 










Input value of A 











Yes (true) Display character “ABS=” 


and value of A 





Display character “ABS=" 
and value of -A 





IF—THEN statement multiplexing 
IF—THEN can be continued after THEN or ELSE. Multiplexing can be per- 
formed within the range of one line. 





IN KEY$ (inkey dollar) 


Gives the character of a depressed key, and a null string if no key is 
pressed. 





FORMAT 
INKEY$ 
Given Value: String type. 


FUNCTION AND UTILIZATION 
When keys other than |[ctrL| + [stop], |[sHiFt], and[ctrRt] are pressed, 
their character is given as data. If no key is pressed, a null string is given. 














Execution example 


10 CLS 

20 PRINT “Press any key.” 

30 KS=INKEYS | Repeats until a key is pressed. 
40 IF K$="” THEN GOTO 30 

50 PRINT K$; 

60 GOTO 30 


When any key is pressed, the character is assigned to variable K$ and 
displayed on the screen in line 50. 


HE INP (inp 


Reads data of a specified I/O port. 








FORMAT 


INP (port number) 
Port number Numeric type constants, variables, array variables, their 
expressions from 0 to 255. i 


FUNCTION AND UTILIZATION 
Inputs and gives data from a specified I/O port. 
See page 196 for I/O port allocations. 








Inputs the value of a variable from the keyboard. 


- 
. 


ae 


ee : 
ie 
FORMAT 
INPUT [prompt statement”;] variable [, variable] [, variable] ..... 
Variable Numeric type, string type, their array variables. 


“Prompt statement” Comment statement for data input. 
Gis Displays only ‘?” without a prompt statement. 





FUNCTION AND UTILIZATION 

Inputs data from a keyboard and assigns it to a variable. At that time, the 
space before the data is ignored. 

@For an INPUT statement of a numeric type variable, the space in the 
middle of data is also ignored. 

@When a comma is input, it is considered to be punctuation for data, 
and the items before the comma are considered to be one data assigned 
to a variable while the comma is not assigned. 

@When a prompt statement is written, it is displayed on the screen when 
data input is requested. If a prompt statement is omitted, only “?” is dis- 
played. 

@The number of variables must be in accord with the data. 


Execution example 


10 INPUT A 
RUN ——_——————— When the prompt statement is omitted. 
°? 


10 INPUT “A="3A 
RUN ——= When the prompt statement is used. 


A=° 


10 INPUT “A AND B ”;A,B 


Since the input data is less than the 


RUN f - ral 
— number of variables, the missing data 
ce) 
Rennes B de is requested by ??, 


10 INPUT “A AND B ”;A,B 


Display when more data is input than 
RUN ——the number of variables 
A AND B ? 1,2,3;4 (Residual data is ignored.) 


?Extra ignored 





ae ire 


a ee 
oe 





INPUTS (input dotiar) | 


1. Inputs a specified number of characters from the keyboard. 
2. Inputs a specified number of characters from a file. 





FORMAT 

1. INPUTS(X) 

2. INPUTS(X, [#] file number) 

X Numeric type constants, variables, array variables, their expres- 

sions from 1 to 255. 

File number @@Ury 1<file numers<numeral specified by MAXFILES=state- 
ment 

Given value: String type. 


FUNCTION AND UTILIZATION 


Execution example 


10 X$=INPUTS (5) 
20 PRINT xs 


When line 10 is executed, keyboard input wait occurs. After 5 characters 
are input, they are assigned to variable X$. Characters are not displayed 
on the screen during keyboard input. 


10 OPEN “CAS: TEST” FOR INPUT AS #1 
20 X$=INPUTS$(50,#1) 
30 CLOSE 


In this program, 50 characters are input from a file saved on cassette 
tape and are assigned to string variable X$. Then the file is closed. 


Range of “X” 

During initial status, if X is outside a range from 1 to 200, an error occurs. 
When the size of the character area is set to more than 255 by a CLEAR 
statement, a value from 1 to 255 can be selected. 








: INPUT # (input number) 


Reads data from a file opened by an OPEN statement, and assigns it to 
a variable. 





FORMAT 
INPUT # file number, variable [, variable] ..... 


File number 1<file numersnumeral specified by MAXFILES=state- 
ment 


Variable Numeric type or string type, their array variables. 


FUNCTION AND UTILIZATION 

Reads data from a file. If the data is numeric, the space, the return code, 
and the line feed code before the data are ignored. 

If the data is string type, the data from the first character to the character 
before the space, comma, return code, and line feed code is read as one 


data. If the characters are inside “ ”, only these characters are read as 
data. 


Execution example 


10 OPEN ”CAS:DATA” FOR INPUT AS #1--Opens a file for read out. 
20 IF EOF(1) THEN GOTO 50 


f Reads data, assigns it to variable 
ri re »AG:PRINT AS A$ and displays it on the screen. 
50 CLOSE #1 


(See 2-6 File processing.) 











[ ‘unction INSTR (in string) : | 


Retrieves a specified character string from among character strings and 
gives its location. 





FORMAT 
INSTR ([N,] X$, Y$) 
N Numeric type constants, variables, array variables, their expres- 
sions from 1 to 255. 


Gay | 
X$, Y$ String type constants, variables, array variables, their ex- 


pressions. 
Given value: Integer type. 


FUNCTION AND UTILIZATION 

Gives the number of a character from the left where Y$ starts in an X$ 
character string as numeric data. When N is specified, retrieval starts 
from Nth character of the X$. 


Execution Example 


PRINT INSTR(3,”WHAT IS THIS?”,71IS”) 
6 


@When the N value is larger than the length of X$ or X$ is a null string, 
or if Y$ can not be found, 0 is given. 


| NT (integer) 






FORMAT 


INT(X) 

X Numeric type constants, variables, array variables, their expres- 
sions. 

Given value: Numeric type. 


FUNCTION AND UTILIZATION 


Execution-example 


PRINT INT (3) ;INT(~3) ; INT (3.58) ; INT (-3.58) 
Sey ese 


Es INTERVAL ON (interval on) 
INTERVAL OFF (interval off) 
INTERVAL STOP (interval stop) 


Validates, invalidates, or holds an interrupt with a built-in timer. 








FORMAT 


INTERVAL ON —Interrupt valid. 
INTERVAL OFF —Interrupt invalid. 
INTERVAL STOP—Interrupt hold. 


FUNCTION AND UTILIZATION 

A command that actually validates (INTERVAL ON), invalidates (INTER- 
VAL OFF), or holds (INTERVAL STOP) an interrupt after declaring an inter- 
rupt with a built-in timer by using ON INTERVAL GOTO. 


(See 2-7 Interrupts.) 





Defines a character string for a function key. 





FORMAT 


KEY function key number, character string 
Function key number @iB Integers from 1 to 10. 
Character string @IP String within 15 characters. 


FUNCTION AND UTILIZATION 

When characters are defined for a function key, a defined character 
string is entered by just pressing a function key. 

@ Function keys from 1 to 5 correspond to [F1J— F5], while numbers 
from 6 to 10 correspond to the pressing of each function key while press- 
ing the | SHIFT] key. 

@When the reset button is pressed or the power is turned off, the func- 
tion key definitions are erased and initialized. 

@A code other than that for a character (Such as return code) can be de- 
fined by using the CHR$ function. 


























Execution example 








KEY 1,” JAPAN” - Defines ‘JAPAN” for [F1]. 














KEY 2,”CLS”+CHR$ (13) ———— Defines CLS [RETURN ] for [Fa]. 














KEY LIST (key list) 


Displays the content of the function keys. 








FORMAT 
KEY LIST 


FUNCTION AND UTILIZATION 


When this command is executed, the character string content defined 
for each function key is displayed. 


Execution example 






























































KEY LIST ee 

co | or ———__—_—___—-}F 1 | 

auto [F2] 

soto LFS | 

list Fa 

run FS 

color 15,4,7———[suirt] + [F1] 

cload” ——_————_sHFT | + |F2 

cont —————___ SHIFT | + |F3 
{ist .——_————__ [SHIFT | + |F4 
run —— [SHIFT] + |F5 














An example of the initial state. It is found that “color 15,4,7” is defined 
for function key 6 (or the [F1] key pressed together with the [SHIFT | key). 





























































































































KEY ON, KEY OFF (key on, key off 


Displays or erases the content of a function key. 











FORMAT 
KEY ON or KEY OFF 


FUNCTION AND UTILIZATION 

Initially the character strings defined for each function key are displayed 
with 5 characters on the last line of the screen. Execute KEY OFF to 
erase this display. 

@ Characters can be output on this line with a PRINT statement after us- 
ing KEY OFF to erase the display. 

@ Execute KEY ON to output this display. 





‘KEY (n) ON (key (n) on) 
KEY (n) OFF (key (n) off) 


KEY (n) STOP (key (n) stop) 


Validates, invalidates or holds a function key interrupt. 





FORMAT AND FUNCTION 
KEY (function key number) ON —Interrupt valid. 
KEY (function key number) OFF —Interrupt invalid. 
KEY (function key number) STOP—Interrupt hold. 
Function key number Constants, variables, array variables, their ex- 
pressions from 1 to 5. 


FUNCTION AND UTILIZATION 
Specifies a function key used for an interrupt with a function key number. 


KEY (1) ON ————Validates an [F1] key interrupt. 
KEY (2) OFF ———— Invalidates an [F2] key interrupt. 








KEY (3) STOP- 








Holds an |F3|key interrupt. 





(See 2-7 Interrupts.) 














LEFTS$ (left dollar) 


Gives an arbitrary number of characters taken from the left of string data 
as String data. 











FORMAT 


LEFTS$ (X$, N) 

X$ @GEB String type constants, variables, array variables, their expressions. 

N Numeric type constants, variables, array variables, their expressions 
from 0 to 255. 

Given value: String type. 


FUNCTION AND UTILIZATION 


PRINT LEFT$(”MSX-BASIC” ,3) 
MSX 
Ok 


PRINT LEFTS$(“MSX-BASIC”,3.8) 
MSX 
Ok 


__ If N is not an integer, numbers 








lf N is 0, a null string is given. 


PRINT LEFTS$(”MSX-BASIC”,0) | 


Ok 


below the decimal point are omitted. 






























































data. 





FORMAT 
LEN(X$) 
X$ String type constants, variables, array variables, their expres- 
sions. 
Given value: Integer type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT LEN (”CHRISTMAS” ) 
9 


When a character string includes a space, 
the space is counted as 1 character. 


PRINT LEN(” THE END” )—— 
7 


@ Also, when acharacter string includes the CHR$ function, it is counted 
as one character. 





BERR 


LET (ict) 


Ee 





Assigns data for a variable. 





FORMAT 
{LET] variable=X 
Variable Numeric type, character type variables, array variables. 


Xx @B Numeric type, character type constants, variables, array varia- 
bles, their expressions. 


FUNCTION AND UTILIZATION 

Assigns a value on the right to the left. 

@For string type constants, they are enclosed inside quotation (”’) 
marks. 

@LET can be omitted. 

@When acertain type of numeric data is assigned to another type of nu- 
meric variable, the numeric data is converted to that type of variable. 


Execution example 


LET N=N+1————— Increases the value of N by 1. 


A%=45.6:PRINT A% 
45 


A$=3+4 


: Since numeric type data was assigned to a strin 
Type mismatch uly 2 2 


type variable, an error Occurs. 


ese LINE (line) 


Draws a Straight line or square on the foreground in the graphic mode. 









FORMAT 
LINE [[STEP] (starting point coordinates)]-[STEP] (end point coor- 
dinates) footor){ te ‘ 

[, BF] 


Starting point coordinates 
Numeric type constants, variables, array variables, their 
expressions from — 32768 to 32767. 
@nn Last location specified by the last graphic instruction. 


End point coordinates 
Numeric type constants, variables, array variables, their ex- 
pressions from — 32768 to 32767. 
Color GTB Integers from 0 to 15. 
GMD Current foreground color. 
B, BF @an@ Draws a straight line. 


FUNCTION AND UTILIZATION 

Draws a Straight line that connects starting point and end point coor- 
dinates (when B, BF is omitted). 

@When “B” is specified, draws a square with a straight line that con- 
nects two specified points as a diagonal. 

@When “BF” is specified, draws a square with a straight line that con- 
nects two specified points as a diagonal, and colors the surrounding 
area. 

@See page 154 for STEP specifications. 


Execution example 


10 CLS os 


20 SCREEN 2 

30 LINE (60,60)-(100,100),1,B 

40 LINE STEP (-10,-10)-(120,160) ,8,BF 
50 GOTO 50 

















Note 


To draw a square with the length of the vertical side and horizontal side 
equal on the screen, specify the starting point and the end point coor- 
dinates so that the number of dots in the vertical side is 1.4 times as that 
of the horizontal side. 





Example: (50,50) (50,50 
50 dots | 50 dots 
50 dots 70 dots 
(100,100) 
Number of dots in the vertical 
side and in the horizontal (100,120) 


side are the same. 
Number of dots in the vertical 
side is 1.4 times that of the 
horizontal. 





Gives a string with up to 254 characters by keyboard input as a string 
type variable. 





FORMAT 
LINE INPUT [prompt statement”;] variable 
“prompt statement” GEER Comment statement for data input. 


@i Displays only “?” without a prompt statement. 
variable String type variables, array variables. 


FUNCTION AND UTILIZATION 

A return code is only considered as data punctuation, and assigns a key- 
board input character string to a variable. When a comma is included in 
a character string, it is assigned as part of the character string. 


Execution example 


10 CLS 

20 LINE INPUT ”“NAME,PHONE? ”;NS 
30 PRINT NS 

RUN 

NAME ,PHONE’? JACK ,OO-11-22 

JACK ,O0-11-22 












= LINE INPUT # (line input number) e 


o 


Reads a String with up to 254 characters from a file, and assigns it to a 
string type variable. 





FORMAT 
LINE INPUT # file number, variable 


File number @uyp 1<file number<numeral specified by MAXFILES =state- 
ment 
Variable @IrP String type variables, array variables. 


FUNCTION AND UTILIZATION 

Reads string type data from a file. However, a space, comma, and line 
feed code are not considered as punctuation for data, which differs from 
the INPUT # statement, and the character string that includes these 
items is assigned to a variable as character string data. Only the return 
code is considered to be punctuation for data. 


Execution example 


10 OPEN ”“CAS:DATA” FOR INPUT AS #1 
20 IF EOF(1) THEN GOTO 60 

30 LINE INPUT #1,A$% 

40 PRINT AS 

50 GOTO 20 

60 CLOSE #1:END 


When a file has been prepared by the following procedure with a file 
name called DATA, 


PRINT #1,”ABC”;”,”; DEF” 
PRINT #1,”GHI JKL”; 
PRINT #1,”MNO” 

PRINT #1, ”PQR” 


and when this data is read by the above program and displayed on the 
screen, it is found that it was read as 3 string type data as follows. 


ABC , DEF 
GHI JKLMNO 
PQR 





BAL IST cist out) ™ 








FORMAT 


LIST [starting line number] [—] [end line number] 

Starting line number Integers from 0 to 65529. 
@D Smallest line number 

End line number Integers from 0 to 65529. 
@n Largest line number 


FUNCTION AND UTILIZATION 
Press |stop| to temporarily stop the screen display. Press |stop| again 
to resume it again. Press |ctrt| and |stop| to suspend it. 





























Execution example 


LIST —————————Displays all lines. 

LIST 40 ————————Displays line 40. 

LIST 20-40 ——————Displays lines from line 20 to line 40. 

LIST -S0 ——————— Displays lines from the starting line to line 50. 
LIST 30- ———————Displays lines from line 30 to the end line. 

LIST. The last line displayed by a LIST statement or a line 


with execution interrupted by an error is displayed. 















: LLIST (line printer list out) 


Prints a currently stored program list with a printer. 








FORMAT 


LLIST [starting line number] [—] [end line number] 

Starting line number @E_ Integers from 0 to 65529. 
@ines Smallest tine number 

End line number Integers from 0 to 65529. 
nnd Largest line number 


FUNCTION AND UTILIZATION 

Specification is the same as that for a LIST statement. A list is not dis- 
played on the screen during the execution of an LLIST statement. 

@lf an LLIST statement is executed when a printer is not connected or 
when a printer is not operational, the computer stops without accepting 
keyboard input. if this occurs, input is accepted by pressing the [CTRL 
and [stop | key at the same time. 



































LOAD (ioaq) 


Loads a BASIC program file into memory from a specified device. 























FORMAT 
LOAD “device name [file name]” 
Device name CAS: ... Cassette tape. 
File name @rre String within 6 characters. If 7 or more characters are 
specified, the 7th character and after are ignored 
@ine Loads the file found first. 


FUNCTION AND UTILIZATION 
When CAS: is specified as a device name, a program saved by an ASCII 
format on a cassette tape by SAVE “CAS: file name” is loaded. 


Execution example 


LOAD "CAS :PROG2” 








LOCATE (locate) : 


Moves the cursor to a specified location. 





sivas 





FORMAT 


LOCATE [X-coordinate], [Y-coordinate], [cursor switch] 
X-coordinate Numeric constants, variables, array variables, their 
expressions from 0 to 39. 
Gi 0 
Y-coordinate Numeric constants, variables, array variables, their ex- 
pressions from 0 to 24. 
Gp o 
Cursor switch 0 .,. Cursor is not displayed. 
1... Cursor is displayed. 


GD | 


FUNCTION AND UTILIZATION 


Execution example 


10 CLS 
20 LOCATE 12,10 
30 PRINT “*kk*k” 
































LOG (natural logarithm) 


Gives the value of a natural logarithm (Loge). 





FORMAT 
LOG (X) 
xX Numeric constants, variables, array variables, their expressions 
larger than 0. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 

The LOG function gives the value of a natural logarithm in which the 
base is e (2.7182818284588). 

@ The value of a logarithm Logab (b > 0), in which a is the base that is 
a positive numeral (a#0), can be obtained by LOG(b)/LOG(a). 


Exeuction example 


PRINT LOG(10) 
2.302585092994 








LPOS (line printer position 


Gives the print head location in the printer buffer. 








FORMAT 
LPOS(X) 
xX An arbitrary numeral (dummy argument). 
Given value: Integer type. 


FUNCTION AND UTILIZATION 

Gives the location of a character currently being printed out to the printer 
in the line printer buffer memory. 

(Start =0) 





2 LPRINT (line print) | 


Outputs the value of an expression to the printer. 





FORMAT 


LPRINT [expression] [Separater] [expression] [Separater] [expression]... 
Expression Numeric and string constants. variables, array variables, 
their expressions. 


@i Line feeds 
Separater MOt 


FUNCTION AND UTILIZATION 
An LPRINT statement outputs data to a printer while a PRINT statement 
outputs data to the screen. See PRINT for details. 


3 LPRINT USING (line print using) 


Outputs data to a printer in a specified format. 


ani 
ae 








Renee 


FORMAT 
LPRINT USING format symbol; expression [expression] ..... 


Expression String and numeric constants, variables, array variables, 
their expressions. 


FUNCTION AND UTILIZATION 

LPRINT USING outputs data to a printer in a specified format while 
PRINT USING outputs data to the screen in a specified format. See 
PRINT USING for details such as those for format symbols. 








iM ERG E (merge) © 





Loads a program saved by an ASCII format, and merges it with a program 
in memory. 





FORMAT 
MERGE ‘device name [file name]” 
Device name CAS: ... Cassette tape. 
File name String within 6 characters. If 7 or more characters are 


specified, the 7th character and after are ignored. 
QU Merges ‘the first file found. 


FUNCTION AND UTILIZATION 

Only CAS: can be specified as a device name. Loads a program saved on 
cassette tape in an ASCII format by a SAVE statement. The existing pro- 
gram in memory, maintained as it is, is merged with the program loaded 
by a MERGE statement. 

elf the line numbers of the program loaded by a MERGE statement are 
the same as that of an existing program in memory, the line numbers of 
the program newly loaded by a MERGE statement are maintained. 


Execution example 


MERGE ”CAS:PROG3” 





MIDS (middle dollar) 


Fetches and gives a part of character data. 





ects 





FORMAT 

MID$ (X$, M [,N]) 

X$ String type constants, variables, array variables, their expressions. 

M Numeric type constants, variables, array variables, their expressions 
from 1 to 255. 

N Numeric type constants, variables, array variables, their expressions 
from 1 to 255. 

@i Gives all characters after the Mth character. 
Given value: String type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT MIDS (” JAPANUKFRANCE” ,6,2) 
UK 


PRINT MID$ (” JAPANUKFRANCE” ,6,2.6) ANUS pot ey neae 


—value, figures below the 
UK decimal point are omitted. 


PRINT MID$(" JAPANUK” ,6,4) | If N characters do not exist after the 


—Mth character, all characters after the 
UK Mth character are given. 
PRINT MIDS (” JAPANUK”,12,5) When the value of M is larger than 
— the length of X$ or when N is 0, 
a null string is given. 





PRINT MIDS (” JAPANUK” ,6,0) 





1 MID$=Y$ (middle dollar) 


Replaces a part of a character string with another character string. 





eee 





FORMAT 
MID$(X$,M[,N])=Y$ 
X$, YS String type constants, variables, array variables, their ex- 


pressions. 

M Numeric type constants, variables, array variables, their ex- 
pressions from 1 to 255. 

N Numeric type constants, variables, array variables, their ex- 


pressions from 1 to 255. 
Qa Mth character and after in X$ are replaced by YS. 


FUNCTION AND UTILIZATION 

Replaces the Mth character and after from the left in the X$ character 
string with the characters from the beginning to the Nth character in Y$. 
However, the length of X$ is not changed after execution. 


Execution example 


10 X$=”" ABCDEFG” 

20 YS="QRSTUVWXY2Z” 
30 MIDS (X$,4,2)=YS 
40 PRINT X$ 

RUN 

ABCQRFG 








M OTO R (motor) 


Turns the motor of the cassette tape recorder on and off. 








FORMAT 


rfON )- 
MOTOR | eat 


FUNCTION AND UTILIZATION 

Connect the computer TAPE terminal to the remote control terminal of 
a cassette tape recorder and place the recorder in a playback or record 
mode. Tape operation starts with MOTOR ON and stops with MOTOR 
OFF. 

When only MOTOR is executed, if it is ON, it is switched to OFF, and if 
it is OFF, it is switched to ON. 





FORMAT 
NEW 


FUNCTION AND UTILIZATION 

New is executed before entering a new program to erase all previous pro- 
grams and enter a command wait state. 

@When a machine language program exists in memory, it is mainained 
even if NEW is executed. 






OCT$ (octonary dollar) ee : a 


Gives an octal expression of numeric data as string type data. 





FORMAT 
OCT$(X) 
x Numeric type constants, variables, array variables, their expres- 
sions from — 32768 to 65535. If it is anegative numeral, itis the same 
as a value in which the value is added to 65536. 
Given value: String type. 


FUNCTION AND UTILIZATION 
Execution example 


PRINT OCT$ (100) 
144 


PRINT OCT$ (65536-32768) 
100000 








number. 





FORMAT 
ON ERROR GOTO line number 
Line number @i~p Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 
Used to prevent an execution interruption caused by an error that oc- 
curred during program execution. When an error occurs after ON ERROR 
GOTO is declared, execution is transferred to a specified line number. 
(Also, when an error results from a direct command, execution is trans- 
ferred to a specified line number.) 


Execution example 


10 ON ERROR GOTO 100 


20 INPUT A 

30 B=SQR (A) 

40 PRINT 7”SQR(A)=”;B END statement that distinguishes a main routine 
50 END —— from the error processing routine. 


100 IF ERR=5 AND ERL=30 THEN PRINT “Inpu 
t a positive number.” ane processing 
110 RESUME 20 routine. 


To invalidate an ON ERROR GOTO statement 
Execute ON ERROR GOTO 0. 


a ON—GOSUB (on—go to subroutine) 






Branches program execution to subroutines that start with specified line 
numbers depending on the value of the expression. 





FORMAT 
ON expression GOSUB line number [, line number] ..... 
Expression @@iry Numeric type variables, array variables, their expressions 
from 0 to 255. 
Line number GEER Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 
100 ON X GOSUB 500,600,700 


In this program, if the value of X is 1, execution branches to a subroutine 
from line number 500, and if the value of X is 2, execution branches to 
a subroutine from line 600, and if it is 3, execution branches to a subrou- 
tine from line 700. 

A return to the main program is accomplished by a RETURN statement. 


Expression value and execution result 

When the expression value is not an integer ... Figures below the decimal 
poini are omitted. 

When the expression value is 0 or larger than the number of the line num- 
ber specified by GOSUB .... Transferred to a statement next to the ON— 
GOSUB statement. 

When the expression value is negative or barger than 256 ..... An error 
occurs. 








: ON—GOTO (on—go to) 


Branches program execution to line numbers that depend on the value 
of an expression. 





FORMAT 
ON expression GOTO line number [, line number] ..... 


Expression @@i%B Numeric type variables, array variables, their expressions. 
Line number Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 
100 ON X GOTO 120,130,180 


In this program, if the value of X is 1, it branches to line 120, if it is 2, it 
branches to line 130, and if it is 3, it branches to line 180. 


Expression value and execution result 

When the expression value is not an integer ... Figures below the decimal 
point are omitted. 

When expression value is 0 or larger than the number of line numbers 
specified by GOTO ... Transferred to a statement next to the ON—GOTO 
statement. 

When the expression value is negative or larger than 255 ... An error 
occurs. 





(ON INTERVAL GOSUB 


(on interval go to subroutine) 





Declares a subroutine to which program branches when an interrupt is 
caused by a built-in timer. 





FORMAT 
ON INTERVAL=Interval time GOSUB line number 
Interval time @iEB Numeric type constants, variables, array variables, their 
expressions from — 32768 to 65535 and other than 0. 
Line number @UB Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 

A statement that declares a subroutine starting line number to which 
program branches when an interrupt is caused by a built-in timer with a 
certain interval. The interrupt spacing is about (interval time x 1/50) se- 
cond. In other words, when the interval time is specified as 50, an inter- 
rupt occurs approximately every second. 


(See 2-7 Interrupts) 
Execution example 


10 ON INTERVAL=S50 GOSUB 100 

20 INTERVAL ON 

30 SCREEN 2,1 

40 SPRITES (1) =CHRS (&H18) +CHRS (&H3C) +CHRS 
(&H66 ) +CHRS (&HDB) +CHRS (&HE7 ) +CHRS (&H7E) + 
CHRS (&H24) +CHRS (&H42 ) 

50 GOTO 50 

100 X=INT(RND (1) *256) : Y=INT (RND (1) *192) 
110 C=INT(RND(1)*14)+2 

120 PUT SPRITE 1, (X,Y),C,1 

130 RETURN 50 


In this program, an interrupt occurs with about 1 second spacing provid- 
ed by lines 10 and 20, and each time an interrupt occurs, the execution 
is transferred to a subroutine from line 100. After a UFO shaped sprite 
pattern is displayed by this subroutine, a return to line 50 occurs caused 
by RETURN 50. 

@When the interval time is set to a negative numeral, it is equal to a 
numeral in which the specified interval time is added to 65536. 











"ON KEY GOSUB oon key go to subroutine 


Declares a Subroutine to which program branches when an interrupt is 
applied by a function key. 


<o 





FORMAT 
ON KEY GOSUB line number [, line number] .... 
Line number @yiyp Integers form 0 to 65529. 


FUNCTION AND UTILIZATION 

A statement that declares the starting line number of a subroutine to 
which program branches when an interrupt is applied by a function key. 
Up to 5 line numbers can be specified after GOSUB by punctuating them 
to sequentially correspond to [F1], [F2], etc. 














Execution example 


10 ON KEY GOSUB 1000, ,2000 
20 KEY(1) ON:KEY(3) ON 


When [Fi] is pressed, execution is transferred to a subroutine from line 
1000, and when [F3] is pressed, it is transferred to the subroutine from 
line 2000 based on the above two lines of the program. 

A return from the subroutine is made by a RETURN statement. 











(See 2-7 Interrupts) 










Hs ON SPRITE GOSUB| 


(on sprite go to subroutine) 





Declares a subroutine to which program branches when an interrupt oc- 
curs due to a sprite overlap. 





fae 


FORMAT 
ON SPRITE GOSUB line number 
Line number Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 

A statement that declares the starting line number of a subroutine to 
which program branches when an interrupt occurs due to an overlap of 
sprite patterns. 


Execution example 


10 ON SPRITE GOSUB 1000 
20 SPRITE ON 


When a sprite overlap occurs, execution is transferred to a subroutine 
from line 1000 based on the above two lines. A return is made from a 
subroutine by a RETURN statement. 


(See 2-4 Screen configurations and graphics, 2-7 Interrupts.) 























ON STOP GOSUB (on stop go to subroutine) » 


Declares a subroutine to which program branches when a |cTRL|+ 
[stop | key interrupt occurs. 
































FORMAT 
ON STOP GOSUB line number 
Line number Integers from 0 to 65529. 


FUNCTION AND UTILIZATION 
A statement that declares the starting line number of a subroutine to 
which program branches when a |ctTrat|+(stop| key interrupt occurs. 

















Execution example 


10 ON STOP GOSUB 1000 
20 STOP ON 


Execution is transferred to a subroutine from line 1000 by simultaneously 
pressing [CTRL | and [stop| based on the above two lines. A return from 
the subroutine is made by a RETURN statement. 














(See 2-7 Interrupts.) 


Precautions 


It is necessary for a program to be terminated somehow when a subrou- 
tine is executed. The only way to terminate the following program is to 


press the [RESET | button. 


10 ON STOP GOSUB 100 

20 STOP ON 

30 PRINT “MAIN ROUTINE” 

40 GOTO 40 

100 PRINT “CTRL+STOP EXECUTED” 
110 RETURN 30 











=ON STRIG GOSUB 


(on stick trigger go to subroutine) 





Declares a subroutine to which program branches when an interrupt is 
caused by the space bar or the trigger button of a joy stick. 






nue 


ee 


FORMAT 
ON STRIG GOSUB line number [, line number] ..... 
Line number @@i~y Integers from 0 to.65529. 


FUNCTION AND UTILIZATION 

A statement that declares the starting line number of a subroutine to 
which program branches when an interrupt occurs by the pressing of the 
space bar or joy stick trigger button. Up to five line numbers can be 
specified after GOSUB by punctuating them with commas. 


ON STRIG GOSUB line No. @, line No. @, line No. @, line No. @, line 
No. @ 

Line No. @ ... Branches when the space bar is pressed. 

Line No. @ ... Joy stick 1, Trigger button 1 

Line No. @ ... Joy stick 2, Trigger button 1 

Line No. @ ... Joy stick 1, Trigger button 2 

Line No. @ ... Joy stick 2, Trigger button 2 


Execution example 


10 ON STRIG GOSUB 1000,2000 , 3000 
20 STRIG(O) ON:STRIG(1) ON:STRIG(2) ON 


When the space bar is pressed, execution is transferred to a Subroutine 
from line 1000, and when trigger button 1 of joystick 1 is pressed, execu- 
tion is transferred to a subroutine from line 2000. Also, when trigger but- 
ton 1 of joystick 2 is pressed, execution is transferred to a subroutine 
from line 3000. 

Return from a subroutine is accomplished with a RETURN statement. 


(See 2-7 Interrupts.) 








FORMAT 
OPEN ‘“‘device name [file name] FOR mode AS [#] file number 
Device name CAS: ... Cassette tape 
CRT: ... Text mode screen 
GRP: ... Graphic mode screen 
LPT: ... Printer 
File name @ard String within 6 characters. If 7 or more characters are 
specified, the 7th character and after are ignored. 


Gn Null-string 
Mode OUTPUT ... Write. 
INPUT ... Read. 
File number 1<file numer<numeral specified by MAXFILES=state- 
ment 


FUNCTION AND UTILIZATION 

An OPEN statement opens a file with a specified file number to perform 
file I/O for a specified device. Since CRT:, GRP:, and LPT: of the devices 
that can be specified are dedicated to write-in, only OUPUT can be speci- 
fied as a mode. On the other hand, since write-in and read-out can be per- 
formed with CAS:, OUTPUT and INPUT can be specified. 

e@When write-in is performed with a file name, read-out can be performed 
by specifying the same file name. 

@ The file number should be equal to or less than the numeral that indi- 
cates the maximum numer of files which can be opened, as specified by 
MAXFILES = statement. 


Execution example 


10 SCREEN 2 

20 OPEN ”“GRP:” FOR OUTPUT AS #1 
30 PSET (120,90) 

40 PRINT #1,”ABC” 

50 GOTO 50 


This is a program that outputs characters on the screen in the graphic 
mode (SCREEN 2). 


(See 2-6 File Processing) 











=— 


Be OUT vou 


Outputs 1 byte data to a specified I/O port. 














FORMAT 


OUT port number, expression 
Port number, expression Numeric type constants, variables, array 
variables, their expressions from 0 to 255. 


FUNCTION AND UTILIZATION 
This is a command that outputs data directly to an I/O port. 
See page 196 for I/O port assignments. 


PAD (pag) 


Provides the status of the touch pad. 














FORMAT 
PAD(N) 
N Integers from 0 to 7. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 

Provides various data from a touch pad by an N value. When N is 0, 1, 2, 
or 3, the status of the touch pad connected to controller terminal A is 
provided. When is 4, 5, 6, or 7, the status of the touch pad connected to 
controller terminal B is given. 














Value of N Semantics for a given value 
Grape 0: Not touched 
~—1: Is touched 
tors X coordinate of a touched location. 
2or6 Y coordinate of a touched location. 





0: Switch is not pressed. 


Seale —1: Switch is pressed. 

















PAI NT (paint) © 


Colors an area Surrounded by a border line. 





FORMAT 
PAINT [STEP] (X-coordinate, Y-coordinate), [display color], [border line 
color] 
X-coordinate @ir~y Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 
Y-coordinate @EB Numeric type constants, variables, array variables, their 
expressions from 0 to 191. 
Display color, border line color 
@ Integers from 0 to 15. 
@and Current foreground color. 


FUNCTION AND UTILIZATION 

Colors an area with a display color inside a border line with a specified 
color including the location specified by X,Y coordinates. 

e@ lf the border line is not completely closed, the entire screen is colored. 
@ln the SCREEN 2 (high resolution) mode, if the display color is not the 
same as the border line color, the entire screen is colored. 

e@See page 154 for STEP specifications. 


Execution example 


10 CLS 

20 SCREEN In SCREEN 2, the same color 
30 CIRCLE (70,70) ,40,10 |————Must be specified for the display 
40 PAINT (70,70) s0 ,10)— color and border line color. 

50 GOTO SO 











CLS 

SCREEN In SCREEN 3, different colors can 
CIRCLE (70,70) ,40,10 -be specified for the display color 
PAINT (70,70) 6,10)— and border line color. 

GOTO 50 


(70.70) 


Medium red 


Dark yellow 





PDL (paddle 


Gives the value from a paddle. 











FORMAT 
PDL (N) 
N Integers from 1 to 12. 
Given value: Numeric type from 0 to 255. 


FUNCTION AND UTILIZATION 

Gives the value obtained from a paddle as numeric type data. When N 
is an odd number, data is provided from the paddle connected to con- 
troller terminal A, and when N is an even number, data is provided from 
the paddle connected to controller terminal B. 

















PEEK (pecw 


Gives the content of a specified memory address. 
































FORMAT 
PEEK (address) 
Address Numeric type constants, variables, array variables, their ex- 
pressions from -—32768 to 65535. In the case of negative 
numerals, their value is the same as if it is added to 65536. 
Given value: Numeric type decimal format. 


FUNCTION AND UTILIZATION 


Execution example 


Assigns the content of memory address 


M=PEEK (50000) 50000 to variable M. 









































PLAY (play) 


Generates a sound according to a subcommand specification. 












































FORMAT 
PLAY subcommand 
Subcommand Character string (constant) inside ‘* ”, or a string type 
variable which is assigned a character string. Capitals 
or small characters. 
Subcommands 
Command Condition Semantics 
Tn Integers of | Specifies the speed of music. The value of n 
(tempo) 32<n<255 indicates the counting of a quarter note for one 
minute. The initial setting is T120. 
On Integers of | Specifies one of 8 octaves. When O4 is 
(octave) 1<ns8 specified, music within the range shown below 
is performed. 
The octave becomes lower as the value of n 
becomes smaller and becomes higher as the 
value of n becomes larger. 
The initial value is O04. 
Ln 1<n<64 Indicates the length of sound. 
(length) 
ui Le. La La Lié6 L32 L64 
ee eee 
Initial setting is L4. 
Nn O<n<%6 Specifies a musical note. 
(note) 
N36 is NO is a rest. 
Py 
The chromatic scale increases as n is 
increased by 1. 



































Command Condition Semantics 
A—G Specifies the musical note within a specified 
An—Gn 1<n<64 octave. 
fate cata © ica 
Cc 8 FGA 
Dr» <E Gra. B 
ye | 
CDE FG “AB 
# (or+) and — are used for a semitone. 
The sound length can be specified by n. (C4 is 
the same as L4C.) When omitted, it is the 
length specified by Ln. 
Rn 1sns64 Specifies a rest. 
(rest) RI R2 R4 Re RIG R32 Re4 
—_- = } 7 y J 7 
‘ Express a dot. 
The length is extended to 1.5 times by placing 
it by one. 
C4.= ,. R4.=2. 
Vn Osnsi5 Specifies the volume. 
(volume) The volume increases as n becomes larger. 
The inital setting is V8. 
Sn Osnsi5 Specifies the volume variation pattern from 
(shape) among the following patterns. 

















Magnitude S=1, 2, 3,9 S=11 
2) eee 
S=4,5,6,7, 15 S=12 
jA _| A 
S=8 S= 13 
_ NAAN EZ 
geele S=14 
KAAAA _[AAAAY 


The initial setting is S1. 

The generation of many different sounds is 
determined by a combination of the S 
subcommand and the M subcommand. 


























Command Condition Semantics 
Mn 1<n<65535 | Determines the cycle of the pattern specified 
modu- by the S subcommand 
lation) The cycle becomes long as the value of n is 
increased. 
The initial setting is M255 








FUNCTION AND UTILIZATION 
PLAY ”*T8003L4CDEFG2.-RABO4CDC2.” 


Based on the above statement, the sound is played according to the fol- 
lowing notes. 


ja 





















































by 4 == === 
| | 

“a 

see 


To express a subcommand with a variable 


MS=”"T8003L4CDEFG2 .RABO4CDC2.” 
PLAY M$ 


A subcommand is assigned to a string type variable, M$, once, then M$ 
is specified in a PLAY statement as a subcommand. 


To express a part of a subcommand with a variable (X variable;) 


10 M$=”"CDEFG2.R” 
20 PLAY ”“O4L4XM$;GAGAG2.R” 
30 PLAY ”XM$;ABOSCDC2.” 


When a subcommand assigned to a string type variable is used in “ ” of 
a PLAY statement, add X before and ; after. In the example above, a sub- 
command assigned to M$ is used in two PLAY statements. 





To express n in a subcommand with a variable (= variable;) 

n which is specified in each subcommand can be aconstant or a variable 
in a PLAY statement. When expressed as a variable, = is added before 
and ; after. 


10 FOR I=1 TO 8 
20 PLAY “O=I;CEG” 
30 NEXT I 


This program plays 8 octave music from PLAY ‘“O1CEG” to PLAY 
“O8CEG”. 


Performance of chords 
Up to 3 commands can be simultaneously played such as 
PLAY A$, BS, C$ 
10 AS="04CDO3B04E2R4” 
20 BS="04EFDG2R4” 


30 C$="04GAGO05SC2R4” 
40 PLAY A$,B$,CS 


This program plays the following notes. 


Orig! 




















(See 2-5 Sound. 






‘ 
PLAY (play) 


& 


Checks if music is being played or not. 





FORMAT 
PLAY (N) 
N @arp Integers from 0 to 3. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 

Three different sounds can be simultaneously played in a PLAY 
statement. 

In the case of PLAY A$, B$, C$; 

the sound of subcommand A$ is output from Channel 1, the sound of B$ 
is output from Channel 2, and the sound of C$ is output from Channel 3. 
The PLAY function checks if data is in the music data buffer of Channel 
1 when N =1, the same for Channel 2 when N=2, and the same for Chan- 
nel 3 when N=3. When data is in the buffer, —1 is given, and when there 
is no data, 0 is given. When N=0, the OR (logical sum) of the buffer sta- 
tus (0 or 1) of all channels is given. In other words, if one of them is —1, 
—1is given. 






ieee 


. 


eee 





mules POINT (point) 





FORMAT 


POINT (X, Y) 

xX, Y Numeric type constants, variables, array variables, their expres- 
sions from — 32767 to 32767. 

Given value: Numeric type (—1 is given when a specified location is outside 
the display area.) 


FUNCTION AND UTILIZATION 


Execution example 


10 SCREEN 3 

20 FOR I=1 TO 250 

30 X=INT(RND(1)*255) 

40 Y=INT(RND(1)*191) 

50 PSET (X,Y),1 

60 NEXT I 

70 FOR Y=O0 TO 191 STEP 4 
80 FOR X=0 TO 255 STEP 4 
90 C=POINT (X,Y) 

100 IF C=4 THEN PSET (X,Y),15 
110 NEXT X,Y 

120 GOTO 120 


The color code for the location (X, Y) is assigned to variable C in line 90, 
and changed into white in line 100 if C is 4 (dark blue). 












HE POKE (poke) | 


Writes data to a specified memory address. 





FORMAT 
POKE address, expression 
Address @i) Numeric type constants, variables, array variables, their ex- 
pressions from — 32768 to 65535. 
Expression @i~py Numeric type constants, variables, array variables, their ex- 
pressions from 0 to 255. 


FUNCTION AND UTILIZATION 


Execution example 


POKE ‘50000,255 -- 





Writes 255 as data to memory 50000. 


POKE &HDOOO,&HA8 ——- Writes A8H as data to memory address DOOOH. 


POS (position) 








Gives the X-coordinate of the cursor position. 





FORMAT 
POS (Xx) 
X An arbitrary numeric value (dummy argument) 
Given value: Integer type 


FUNCTION AND UTILIZATION 


Execution example 


10 INPUT AS 

20 PRINT AS; :X=POS (X) 
30 IF X>=5 THEN CLS 
40 PRINT:GOTO 10 


The value of the cursor X-coordinate is given to the variable X based on 
line 20, X= POS (X). As a result, the screen is cleared by inputting a string 
with 5 characters or more than 5 characters for A$. 








pe PRESET (point reset) | 


Marks or erases a dot on the screen in the graphic mode. 





FORMAT 
PRESET [STEP] (X-coordinate, Y-coordinate) [, color] 
X, Y-coordinate Numeric type constants, variables, array variables, 
their expressions from — 32768 to 32767. 
Color Integers from 0 to 15. 
Gi Current background color. 


FUNCTION AND UTILIZATION 

When executed with color omitted, a dot is marked with the same color 
as the background color. As a result, if something is drawn at a specified 
location with a color other than the background color, it looks as if a 
point at the same location was only erased. 

@When a color is specified, it functions exactly the same as when a 
color is specified by PSET. 

@See page 154 for STEP specifications. 

@See PSET for a program example. 


HE PRINT oorint) | 


Displays numeric data or character data on the text screen. 














FORMAT 
PRINT expression [Separator] [expression] [Separator] [expression] ..... 
Expression Numeric type or string type constants, variables, array 
variables, their expressions. 
Separator Comma (,) or semicolon (;). 


FUNCTION AND UTILIZATION 


Expression (data) writing method 

Numeric type constants, numeric type and string type variables are writ- 
ten as they are, and string type constants are written inside quotation 
marks (" ”). 


Separator function 

When data is punctuated with a comma (,), Spaces are inserted between 
the data by a 14 digit tab function, and when it is punctuated with a semi- 
colon (;), it is followed by the next data. 

lf a separator is not written at the end, line feed is performed after the 
data display. If a separator is written at the end, data of the next PRINT 
statement continues on the same line without a line feed. 


Numeric data and signs 

In regard to signs that indicate positive or negative, “+” is omitted while 
“_” ig displayed as it is. (If a“; separator is used when positive numeric 
data is displayed, twospacesare inserted between data to provide space 
for a sign. 


Omitted format 
The same result can be obtained by inputting “?” instead of PRINT. 


Execution example 


10 A$S="ABC” : BS=” DEF” 

20 PRINT A$;BS 

30 PRINT AS,BS 

40 PRINT 

50 PRINT ”MSX” 

60 PRINT +50,-50 

70 ?”PERSONAL COMPUTER” 











RUN 
ABCDEF Result of line 20. 
ABC DEF Result of line 30. 
Result Of line 40. 
MSX Result of line 50. 
50 -50 Result of line 60. 





PERSONAL COMPUTER 





Result of line 70. 








PRINT USING (print using) 


Outputs data to the screen in a specified format. 





— 

ee es 

— 
Regan nals NRO 


FORMAT 
PRINT USING format symbol; expression [expression] ... 
Expression @uep String type and numeric type constants, variables, array 
variables, their expressions. 


FUNCTION AND UTILIZATION 
The value of an expression is displayed in a format specified by a format 
symbol. 


Format symbols for character type data 





Symbol Expression format and Execution example 





ee Outputs the first 1 character. 


PRINT USING ”!”;”United”,”Nation” 
UN 





‘\N.\" | Outputs n+2 characters. When data is smaller than n+2 
T characters, inserts spaces for the residual characters. 

n spaces 

PRINT USING ”“\) \”;”ABCDEF”,”GHI”,” JKLMN” 

ABCDGHI JKLM 





SOU Outputs all character string. 


10 A$S="Nor th” :BS="South” 

20 PRINT USING “& Pole ”;A$,BS% 
RUN 

North Pole South Pole 





















Format symbols for numeric type data 





Symbol 


Expression format and Execution example 





eye 


Writes # by the number of numeral digits to be displayed. 
Decimal point is “ 


PRINT USING “POINT : ###.4#7 5123.4 
POINT :123.4 


@When the number of integer digits is less than the specified 
# number, data is displayed with right justification, and if it is 
more, ‘‘%” is added before the data. 


10 PRINT USING “####”; 12 
20 PRINT USING 7#4###7; 12345 


@When the number of digits in a fraction of numeric data is 
smaller than the specified # number, “0” is added, and when it 
is larger, it is rounded to the nearest whole number. 


10 PRINT USING “##.##7525.3 
20 PRINT USING “##.##7;25.345 
RUN 

25.30 

25.35 


The “+” sign of numeric data is ignored and the ‘‘—” sign is 
counted as one digit. 


10 PRINT USING “###” ; +123 
20 PRINT USING ”###” 5-123 
RUN 

123 

%-123 





“+” is added if it is a positive numeral, and ‘‘—” is added if it 
is a negative numeral before or after the numeric data. 


10 PRINT USING “+####"5;123,-123 
20 PRINT USING “####+7;123,-123 


RUN 
+123 -123 
123+ 123- 











—” is added after negative numeric data. 


PRINT USING “###-";123,-123 
123 123- 
































2K The space before numeric data is filled with “* °. One “*” in 
the format expresses one digit. 
10 PRINT USING “Xxk######” 5123 
20 PRINT USING “xkx######” 5-234 
RUN 
KKKKK123 
KKKK-234 
EEE Adds “f£” before numeric data. One “£” in the format is counted 
as one digit. 
10 PRINT USING “ce ###” 51234 
20 PRINT USING “+£f ###” ;-1234 
RUN 
£1234 
-£1234 
“ok ok 2” i Adds “Pe” just before the numeric data, and space before that is 
filled with ‘ * ” 
PRINT USING "xXxed#H#d. #47 512.34 
KkKKE12.34 
oaks When this is specified somewhere before the decimal point, it 
is displayed by the insertion of commas between each 3 digits 
to the left of the decimal point. 
PRINT USING "“#, ###### .##7 512345 .67 
12,345.67 
“AANA” | Displays numeric data by floating point type. 





“AAAA” corresponds to the digits for the exponent part. 


PRINT USING “#4. ##°°°°” 5234.56 
2.35E+02 











PRINT # (print number) | 


Writes data to a file opened by an OPEN statement. 








FORMAT 
PRINT # file number, expression 
File number 1<file numbersnumeral specified by MAXFILES=state- 
ment 
Expression String type and numeric type constants, variables, array 
variables, their expressions. 


FUNCTION AND UTILIZATION 
Outputs data to a file opened by an OPEN statement. 


Execution example 


10 OPEN ”CAS:DATA” FOR OUTPUT AS #1 — Opens a file to write-in 
20 FOR I=0 TO 4 

30 READ AS 

40 PRINT #1,A$;”,” 3 ———Writes data to a file. 

50 NEXT I 

60 CLOSE #1 

70 DATA TOKYO,LONDON,PARIS,PEKING,NEW YORK 


This is a program which sequentially writes data written in line 70 to cas- 
sette tape with a file name “DATA”. 


(See 2-6 File Processing.) 





100 


Es PRINT # USING (print number using 


Writes data to a file opened by an OPEN statement in a specified format. 








FORMAT 
PRINT # file number USING format symbol; expression 
File number 1<file numbers numeral specified by MAXFILES =state- 
ment 
Expression String type and numeric type constants, variables, array 
variables, their expressions. 


FUNCTION AND UTILIZATION 
This format can be specified when data is output toa file. See PRINT US- 
ING for a format symbol. 


oo PSET (point set) 


Marks a dot on a graphic mode screen. 





FORMAT 
PSET [STEP] (X-coordinate, Y-coordinate) [, color] 
X, Y coordinates Numeric type constants, variables, array variables, 
their expressions from -— 32768 to 32767. 
Color Integers from 0 to 15. 
@in8 Current foreground color. 





FUNCTION AND UTILIZATION 


Execution example 


10 SCREEN 2 

20 FOR X=0 TO 255 

30 PSET (X+1,100) ————\Draws a dot. 

40 PRESET (X,100)—————Erases the dot drawn before. 
50 NEXT X 


— See page 154 for STEP specifications. 





iPUT SPRITE (put sprite) 


Displays a specified sprite pattern at an arbitrary location on a specified 
sprite plane. 





FORMAT 
PUT SPRITE sprite plane number [[STEP] (X-coordinate, Y-coordinate)], 
{color], [Sprite number] 
Sprite plane number Integers from 0 to 31. 
X-coordinate Numeric type constants, variables, array variables, their 
expressions from —32 to 255. 
Y-coordinate Numeric type constants, variables, array variables, their 
expressions from —32 to 191. 
STEP (X-coordinate, Y-coordinate) 
@n Previous location specified by the last graphic in- 
struction. 
Color Integers from 0 to 15. 
@ Current foreground color. 
Sprite number For 8x8 dots, it is from 0 to 255. 
For 16x 16 dots, it is from 0 to 63. 
@ine Same as the sprite plane number 


FUNCTION AND UTILIZATION 
Execution example 


10 SCREEN 2 

20 SPRITES (1) =CHRS (&H18) +CHRS (&H3C) +CHRS 
(&H66 ) +CHRS (&HDB) +CHRS (&HE7 ) +CHRS (&H7E) + 
CHRS (&H2 4) +CHRS (&H42 ) 

30 X=0:Y=0:DX=1:DY=1 

40 PUT SPRITE O,(X,Y),,1 

50 X=X+DX: Y=Y+DY 

60 IF X>250 OR X<O THEN DX=-DX 

70 IF Y>190 OR Y<O THEN DY=-DY 

80 GOTO 40 


A UFO shape is defined in line 20 as a sprite pattern assigned to sprite 
number 1. The sprite pattern is displayed on the screen by a PUT SPRITE 
statement in line 40. The sprite plane number is 0. Since the display color 
is omitted, it is the same as the foregound color that was set. The UFO 
pattern appears to fly around the screen because the X, Y values that 
specify the display location are changed. 





(See 2-4 Screen configuration and graphics.) 





FORMAT 
READ variable [, variable] [, variable] ..... 
Variable Numeric type or string type. 


FUNCTION AND UTILIZATION 

Reads data in a sequence starting from the first data in the DATA state- 
ment that has the smallest number in a program, and assigns them se- 
quentially to variables in the READ statement. 

@When a plural number of numeric type or string type variables are ar- 
ranged in one READ statement, they are punctuated with a comma (,). 
@®The variable type must be in accord with the corresponding data. 


10 READ A,B,C,D$,E$% 
20 PRINT A,B,C,D$,ES 
100 DATA 5,10,20,ABC, XYZ 


@When a plural number of READ statements exist in a program, the 2nd 
READ statement starts reading from data that is next to data read by a 
previous READ statement. 

@When a RESTORE statement is executed, the READ statement readout 
executed next returns to the smallest DATA statement after the line num- 
ber specified by the RESTORE statement. 


Execution example 


10 READ A,B,C 
20 READ D$,E$S 
30 PRINT A;B;C;D$;E$ 
100 DATA 10,20,30, ABC, DEF 
RUN 
10 20 30 ABCDEF 





ieee REM (remark) 


Inserts a comment statement in a program. 





FORMAT 
REM comment statement 


FUNCTION AND UTILIZATION 
A REM statement is used to insert a comment statement so that a pro- 
gram list can be easily read. 


Execution example 


10 
20 


10 
20 


10 
20 


RUN 


Although a REM statement is displayed when a 
REM MUS IC ——————- program is listed, it is skipped during program 


PLAY “T60CEGEC1” execution. 


*MUSIC A Single quotation mark (’) can be used instead of REM. 


PLAY “T60CEGEC1” 


PRINT “MSX”:REM Output 
PRINT “PERSONAL COMPUTER” ’Output 


MSX 
PERSONAL COMPUTER 


104 


Although a colon (:) is required when REM is added after 
another statement, it can be omitted by using ‘''”’. 





ee RENUM (renumber) | 


Renumbers the lines of a program. 








FORMAT 


RENUM [new starting line number], [old starting line number], 
[increment] 
New starting line number Integers from 0 to 65529 
Gi 10 
Old starting line number Integers from 0 to 65529 
Gi Smallest line number before execution. 
Increment Integers from 0 to 65529. 
Gi 10 


FUNCTION AND UTILIZATION 

Used to renumber lines after a program correction. 

@ The line number jumped to in a GOTO or GOSUB statement can be cor- 
rectly renumbered by executing a RENUM statement. However, if the 
specified line number jumped to in a GOTO statement, etc. does not exist 
when RENUNM is executed, the line number jumped to in a GOTO state- 
ment is not changed and an error occurs. 


Execution example 


RENUM t——WY————Renumbers all lines from line 10 with an increment of 10. 
____ Renumbers all lines to the line numbers beginning 
RENUM 100,,100 with line 100, having an increment of 100. 
Renumbers all lines to the line numbers beginning 
PENN 00 with line 100, having an increment of 10. 
RENUM 100,38 ,20 ——Renumbers the line 38 and after to the line numbers 
beginning with line 100, having an increment of 20. 





LIST Executes LIST. 
15 FOR I=0 TO 10 

20 A=A+1 

23 PRINT A 

35 NEXT I 





RENUM Executes RENUM. 


LIST Executes LIST again. 
10 FOR I=0 TO 10 

20 A=A+1 

30 PRINT A 

40 NEXT I 











R ESTO R E (restore) | 


Specifies a DATA statement read by a READ statement. 





FORMAT 
RESTORE [line number] 


Line number Integers from 0 to 65529. 
@ine DATA statement with the smallest line number. 


FUNCTION AND UTILIZATION 

A RESTORE statement is used when the same data has to be read a 
plural number of times. 

When a RESTORE statement is executed, the next READ statement 
starts reading data from the DATA statement with the smallest line num- 
ber after the line number specified by the RESTORE statement. 


Execution example 


10 READ A,B,C 

20 READ D,E,F 

30 RESTORE 110 

40 READ G,H,I 

50 PRINT A;B;C;D;E;F;G;H;I1 

100 DATA 10,20,30 

110 DATA 40,50,60 

RUN 

10 20 30 40 50 60 40 50 60 








Ge al R ESU M E (resume) 


Returns execution to a main program after execution of the error 
processing routine. 





FORMAT 
0 
RESUME [< line number >] 
NEXT 


Line number Integers from 0 to 65529. 
(and Line where an error occurred. 


FUNCTION AND UTILIZATION 


Execution example 


RESUME 0 or RESUME Returns to a statement where an 


error occurred. 


RESUME 100 ————Returns to line 100. 


(See the program example in ON ERROR GOTO.) 





RIGHTS (right dollar 





Gives an arbitrary number of characters taken from the right of string 
data as string data. 





FORMAT 
RIGHTS (X$, N) 


X$ String type constants, variables, array variables, their expressions. 

N Numeric type constants, variables, array variables, their expressions 
from 0 to 255. 

Given value: String type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT RIGHTS$(”I LOVE TOKYO” ,5) 
TOKYO 


PRINT RIGHT$(”I LOVE TOKYO” ,5.3) Ve amenceice 
TOKYO | oe 


decimal point are omitted. 


PRINT RIGHTS(”I LOVE TOKYO”,0) 


When N is 0, a null 
string is given. 


Ok 


Function| RND (random) 


Gives a random positive number less than 1 (including 0) 








FORMAT 


RND (xX) 
X Numeric type constants, variables, array variables, their expressions. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 


When X is larger than 0 
Random numbers are always generated in the same sequence. 





10 FOR N=1 TO 10 

20 RPINT RND(1) 

30 NEXT N 

RUN 
.59521943994623 
. 16658628050158 
.76597651772823 
.57756392935958 
.73474759503023 
. 18426812909758 
.37075377905223 
.94954151651558 
.63799556899423 
.47041117641358 


When X is negative 
Generates a series that corresponds to the value of X, and after that 
generates random numbers with this series. 


10 PRINT RND(-1) 

20 FOR N=1 TO 10 

30 PRINT RND(N) 

40 NEXT N 

RUN 
-04389820420821 
-0962486816692 
-21069655852301 
- 3265173630504 
-47775124336581 
- 3409147084636 
. 12971184081661 
-0977770174288 
-35157860175541 
- 835389696666 
- 639026 41386221 


When X is 0 
Gives the same value as that generated before. 


10 PRINT RND.(1) 
20 PRINT RND(O) 
30 PRINT RND(-1) 
40 PRINT RND(O) 
RUN 
-99521943994623 
-99521943994623 
-04389820420821 
-04389820420821 





sie) 


A: 





S 


FORMAT 
RUN [line number] 
Line number Integers from 0 to 65529. 
@i Executes from the starting line. 


FUNCTION AND UTILIZATION 

When RUN is executed, a program is executed after all variables are 
undefined (numeric variables are set to 0, and string variables are set to 
null strings). After program execution has been terminated, a command 
wait status occurs. 

@ Press |stop| to temporarily stop program execution. Execution is re- 
sumed by pressing it again. 

Press [CTRL and [stop |to interrupt a program. In this case, it can be re- 
sumed by a CONT command. 



































oo ae . 
...:.—OS—ststi‘i‘O‘ONNRNN_LLC 


FORMAT 

SAVE “device name [file name]’ 
Device name @Uirp CAS: ... Cassette tape 

CRT: ... Text mode screen 

GRP: ... Graphic mode screen 

LPT: ... Printer 

File name @E String within 6 characters. If 7 or more characters are 

specified, the 7th character and after are ignored. 


GD Null string 


FUNCTION AND UTILIZATION 
When CAS: is specified as a device name, a BASIC program in memory 
is saved on cassette tape in an ASCII format. 


Execution example 


SAVE “CAS :PROG2” 


@A program to be merged with a program in memory by a MERGE state- 
ment must be saved with an ASCII format. 





oa SCREEN (screen 





Sets the screen display mode, sprite size, key sound or no key sound, and 
the cassette interface baud rate, and also selects the type of printer. 





FORMAT 
SCREEN [mode], [sprite size], [key click switch], [baud rate], [printer 
type] 
Mode 0, 14, 20r3. 
Ga Current mode. 

Sprite size 0,1, 20r3. 

GD Current size. 
Key click switch 0 or integers from 1 to 255, 

GD Current state. 

Baud rate 1 or 2. 

QD Current baud rate. 
Printer type Integers from 0 or 1 to 255. 

QD Current printer type. 












































Modes 
Specified value Mode 
0 40 characters x 24 lines Text mode 
1 32 characters x 24 lines Text mode 
2 High resolution graphic mode 
3 Multi-color mode 
Sprite size 
Specified value Size 
0 8x 8 dot unmagnified 
1 8x 8 dot magnified 
2 16 x 16 dot unmagnified 
3 16 x 16 dot magnified 





Key click switch 





Specified value Key depression sound 
0 No 


Other than 0* Yes 
“Range from 1 to 255 












































Baud rate 
Specified value Baud rate* 
1 1200 baud 
2 2400 baud 














“Cassette interface baud rate 


Printer type 





Specified value Printer 
0 MSX printer** 


Other than 0* Non MSX printer*** 


* Range from 1 to 255 
** A printer that has graphic characters, compatible with MSX persona 


computers. 
***For non MSX printers, graphic characters are converted 


to spaces. 




















Initial value specification and omission 
When a specification is omitted, the presently selected mode is main- 
tained. The initial state is as follows. 


Mode: 40 characters x 24 lines text mode (WIDTH 37) 
Sprite size: 8x8 dot unmagnified 

Key click switch: Key click sound 

Baud rate: 1200 baud 

Printer type: MSX printer 


Execution example 
10 SCREEN 0O,,1 


40 character x 24 line text mode, with key click sound. 





10 SCREEN ,,;2 


Baud rate is selected as 2400 baud. 





High resolution graphic mode. Sprite is 16x 16 dot 
10 SCREEN 2,3 raaanitied: 





10 SCREEN 2 

20 FOR I=0 TO 255 
30 PSET (1,100) 
40 NEXT I 

50 GOTO 50 


When program execution has been terminated, the screen returns to the 
text mode (SCREEN 0 or 1). As a result, when the graphic mode is to be 
maintained, program exeuction is as shown in line 50 of the above pro- 


gram. press | CTRL| and |stop|at the same time to stop execution. 
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SGN (sign) | 





Gives 1 when numeric data is positive, 0 when it is 0, and —1 when it is 
negative. 





FORMAT 
SGN (X) 
xX Numeric type constants, variables, array variables, their expres- 
sions. 
Given value: Integer type. 


FUNCTION AND UTILIZATION 


Execution example 


10 INPUT A 


20 IF SGN(A)=-1 THEN PRINT “Negative” 
30 GOTO 10 


“NEGATIVE” is displayed in line 20 only when the value assigned to A is 
negative. 





BE SIN (sinc) 
Gives the sine value for numeric data. 


es 
i 





FORMAT 
SIN (X) 
X Numeric type constants, variables, array variables, their expres- 
sions. (Unit: Radian) 
Given value: Floating point type constants from —1 to 1. 


FUNCTION AND UTILIZATION 
Execution example 


PRINT SIN(3.14/3) 
-86575983949239 


PRINT SIN (60X*3.14/180) 
-86575983949239 


@To give X in degree units, use the formula SIN (X * 7/180). 








SOUND (sounq) - 





Generates sound effects by writing data directly to the PSG (Programma- 
ble Sound Generator) register. 





FORMAT 
SOUND register number, expression 
Register number Integers from 0 to 13. 
Expression Constants, variables, array variables, their expres- 
sions within the determined range for each register. 


PSG register functions and the write data range 


















































Register No. Function Data range 

0 0—255 
Channel A frequency 

1 0—15 

2 0—255 
Channel B frequency 

3 0—15 

4 0—255 
Channel C frequency 

5 0—15 

6 Noise frequency 0—31 

7 Selects a channel for tone and 0—63 

noise generation. 
8 Channel A volume 0—15 
9 Channel Bovolunve Volume variation 
occurs when 16 
10 Channel C volume is selected. 
11 0—255 
Volume variation pattern frequency ;-—___L_, 
12 0—255 
13 Volume variation pattern selection o—14 








FUNCTION AND UTILIZATION 


Execution example 





10 SOUND 0,56 Sets the Channel A frequency to 400 Hz. 


20 SOUND 1,1 
30 SOUND 7,254 Selects a Channel A tone. 
40 SOUND 8,8——————— Selects the Channel A volume. 





When this program is executed, a 400 Hz sound is continuously output. 
Press [cTr_| + [stop] to stop this. 

















(See 2-5 Sound.) 
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feta S PACE$ (space dollar) | 


Gives an arbitrary number of spaces as string data. 








FORMAT 


SPACES (N) 


N Numeric type constants, variables, array variables, their expres- 
sions from 0 to 255. 
Given value: String type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT SPACES (5) ;” ABC” 
ABC 
Lis spaces 


@When N is not an integer value, figures below the decimal point are 
omitted. 


SPC (space) 


Outputs an arbitrary number of spaces. 








FORMAT 


SPC (N) 

N Numeric type constants, variables, array variables, their expres- 
sions from 0 to 255. 

Given value: String type. 


FUNCTION AND UTILIZATION 
The SPC function can only be used in PRINT and LPRINT statements. 


Execution example 
PRINT “ABC” ;SPC (10) ;”DEF” 
ABC DEF 
|_____40 spaces 


— @When N is not an integer value, figures below the decimal point are 
omitted. 


MS SPRITE ON 
SPRITE OFF 


SPRITE STOP 





Validates, invalidates, or holds an interrupt caused by a sprite overlap. 





FORMAT 
SPRITE ON —Interrupt valid 
SPRITE OFF —Interrupt invalid 
SPRITE STOP—Interrupt hold 


FUNCTION AND UTILIZATION 

A command used to actually validate, (SPRITE ON), invalidate (SPRITE 
OFF), or hold (SPRITE STOP) an interrupt after an interrupt caused by 
sprite overlap is declared by an ON SPRITE GOSUB statement. 


(See 2-4 Screen configuration and graphics, 2-5 Interrupts.) 


SQR (square root) 


Gives the square root value of numeric data. 








FORMAT 
SQR (X) 
X @ErB Numeric type constants, variables, array variables, their expres- 
sions over 0. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT SQR (100) 
10 
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FORMAT 
STICK (N) 


N @Ere 0, 1 or 2. 
Given value: Integer type. 


FUNCTION AND UTILIZATION 

Gives the direction of cursor keys when N=0, that for joystick 1 when 
N=1 and that for joystick 2 when N=2. The range of given values that in- 
dicate the direction is from 0 to 8. When no cursor key is pressed, or 
when joysticks are centered, 0 is given. 








1 
8 UP 2 
Left up Right up 
7 NS va 3 
Left Center Right 





Ge 


5 Right down 
Down 





6 
Left down 


Execution example 


10 CLS 

20 X=14 

30 LOCATE X,10:PRINT ” ”; 

40 D=STICK (0) 

50 IF D=O THEN LOCATE X,10:PRINT “x” 
60 IF D=3 THEN X=X+1:IF X>28 THEN X=28 
70 IF D=7 THEN X=X-1:IF X<O THEN X=0 
80 LOCATE X,10:PRINT “x”; 

90 GOTO 30 


A program that moves “ *” to the left and right on the screen by using 
the left and right cursor keys. The value given to variable D in line 40 de- 
pends on whether a cursor key is pressed or not. The X-coordinate, in 
which “ *” is displayed by a given value, is modified in line 50, 60, and 
70. 





FORMAT 
STOP 


FUNCTION AND UTILIZATION 

When a STOP statement is executed, program execution is interrupted. 
@When a direct mode CONT statement is executed, execution restarts 
from the statement after the interrupted statement. : 





: STOP ON (stop on) 
STOP OFF (stop off) 
STOP STOP (stop stop) 





Validates, invalidates or holds an interrupt by the + [stop | key. 





FORMAT 
STOP ON —Interrupt valid 
STOP OFF —Interrupt invalid 
STOP STOP—Interrupt hold 


FUNCTION AND UTILIZATION 

Commands that actually validate (STOP ON), invalidate (STOP OFF), or 
hold (STOP STOP) an interrupt after declaring an interrupt by + 
stop |using an ON STOP GOSUB statement. 





(See 2-7 Interrupts.) 
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STRIG (stick trigger). oo 


Gives —1 when the space bar or a joystick trigger button is depressed, 
and 0 when they are not depressed. 





FORMAT 
STRIG (N) 


N Integers from 0 to 4. 
Given value: Integer type 


FUNCTION AND UTILIZATION 

Gives the space bar status when N=0, joystick 1 trigger button status 
when N=1, N=3, and the joystick 2 trigger button status when N=2, 
N=4. The given value is 0 when they are not depressed and —1 when 
they are depressed. 


Execution example 


10 CLS 

20 COLOR ,C,C 

30 IF STRIG(O)=0 THEN GOTO 20 
40 C=C+1:IF C>15 THEN C=0 

50 GOTO 20 


A program that changes the color of the screen every time the space bar 
is depressed. 








co STRIG ON (stick trigger on) : 
STRIG OFF (stick trigger off) 
STRIG STOP (stick trigger stop) 





Validates, invalidates or holds an interrupt by the space bar or a joystick 
trigger button. 





FORMAT 
STRIG(n) ON —Interrupt valid 
STRIG(n) OFF —Interrupt invalid 
STRIG(n) STOP—Interrupt hold 
n Numeric type constants, variables, array variables, their expres- 
sions from 0 to 4. 


FUNCTION AND UTILIZATION 

Specifies the space bar, joystick 1 or 2 trigger buttons used for an inter- 
rupt by “n”. The line number of the corresponding subroutine must be 
specified by an ON STRIG GOSUB statement. 
































Value of n Specifies 

0 Space bar 

1 Joystick 1 trigger button 1 

2 Joystick 2 trigger button 1 

3 Joystick 1 trigger button 2 

4 Joystick 2 trigger button 2 
STRIG(O) ON —W———Validates a space bar interrupt. 
STRIG(1) OFF ———Invalidates a joystick 1 trigger button 1 interrupt. 
STRIG(2) STOP ————holds a joystick 2 trigger button 1 interrupt. 


(See 2-7 Interrupts.) 





STR$ (convert to string). 





Converts numeric type data on string type data. 





FORMAT 
STRS$(X) 
Xx Numeric type constants, variables, array variables, their expres- 
sions. 
Given value: String type 


FUNCTION AND UTILIZATION 

When numeric data is negative, the first character of the given string 
data is—. When it is 0 or positive, the first character of given string data 
is a space. 


Execution example 


10 X=100:Y=200 

20 X$=STRS$(X) : YS=STRS (CY) 
30 PRINT X+Y 

40 PRINT X$+Y$ 

RUN 

300 

100 200 


x$ Y$ 





Function | STRING$ (string dollar) 


Gives the character of a given character code or the starting character 
of a given character string continuously by an arbitrary number as string 
data. 





FORMAT 

STRINGS (N, J) 

STRINGS (N, X$) 

N Numeric type constants, variables, array variables, their expressions 
from 0 to 255. 

J @arp An arbitrary character code (See the Character Code Table on page 
186.) 

X$ String type constants, variables, arry variables, their expressions. 

Given value: String type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT STRINGS (10,70) 
FFFFFFFFFF 


PRINT STRINGS (5, ”ABC”) 
AAAAA 





: SWAP (Swap) 


Exchanges the value of two variables. 








FORMAT 
SWAP variable, variable 
variable Numeric type or string type variables, array variables. The 
two variables must have the same type. 


FUNCTION AND UTILIZATION 


Execution example 
10 A=3:B=5 
20 SWAP A,B 
30 PRINT “A=";A 
40 PRINT “B=";B 
RUN 
A= 5 
B= 3 








TAB (tab) 


Moves the cursor from the-beginning of a line to the right by the number 
of specified characters. 





FORMAT 
TAB(N) 
N Numeric type constants, variables, array variables, their expres- 
sions from 0 to 255. 


FUNCTION AND UTILIZATION 

The TAB function can only be used in PRINT and LPRINT statements. 
When N is 0, it is on the extreme left, and when it is a value in which 1 
is subtracted from the number of characters on one line, it is on the ex- 
treme right. 


Execution example 


PRINT TAB(S) ; “AAA” 
—__— AAA 
5 spaces 


TAN (tangent) 


Gives the tangent value for numeric data. 











FORMAT 
TAN (X) 
xX Numeric type constants, variables, array variables, their expres- 
sions. (Unit: radians) 
Given value: Floating point type constant. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT TAN (3.14/3) 
1.72992922009 


PRINT TAN (60X*3.14/180) 
1.72992922009 


@To give X in degree units, use the formula TAN (X * 7/180). 





is) 


I TROFF (trace off)| 





FORMAT 
TROFF 


FUNCTION AND UTILIZATION 
When aTROFF statement is executed in a direct or indirect mode during 
TRON statement execution, the display of a line number is released. 


i TRON (trace on). 


Displays executed line numbers. 








FORMAT 
TRON 


FUNCTION AND UTILIZATION 

When a TRON statement is executed once by a direct or indirect mode, 
the line number executed after that is displayed on the text mode screen 
inside [ ]. It is used for program debug (correction), etc. 

@When the screen is placed in a graphic mode by a SCREEN statement, 
the line number is not displayed. 


Execution example 


10 TRON 

20 FOR I=0 TO 3 

30 A=I+1:PRINT A 
40 NEXT I 
50 TROFF 

RUN 

{20] [30] 

[40] [30] 

(40) [30] 

40] [30] 

[40] [50] 


PWNFK 


USR (user) é 





Gives the result obtained after the execution of a machine language rou- 
tine that starts from an address defined by a DEFUSR statement. 





FORMAT 
USR [X] (1) 
X GD Integers from 0 to 9. 
Gi 0 
| @iEB Numeric type or string type constants, variables, array variables. 
Given value: Depends on the user function. 


FUNCTION AND UTILIZATION 

X is a user program number. The number specified by DEFUSR is used. 
| is a variable or constant that indicates the value to be transferred from 
BASIC to a subroutine. 


Execution example 


DEFUSRO=&HEOOO 
X=USRO (1) 


Based on these statements, the subroutine after the address &HEOOO is 
executed with the resultant value given to BASIC. 


(See 2-8 Machine language subroutines.) 
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a as - 


FORMAT 
VAL (X$) 
X$ @GEB String type constants, variables, array variables, their expressions 
that express numerals. 
Given value: Numeric type. 


FUNCTION AND UTILIZATION 


Execution example 


PRINT VAL ("5") 
5 


PRINT VAL (” 5”) 


S —— The space before string type data is ignored. 









VARPTR variable pointer) oe : 


Gives the starting address in memory where data assigned to a specific 
variable is stored. 





ae 


FORMAT 
VARPTR (variable) 
variable Numeric type and string type variables, array variables. 


FUNCTION AND UTILIZATION 

Gives the decimal starting address in memory where a value assigned to 
a variable is stored. The given value ranges from — 32768 to 32767. If it 
is negative, the actual address is one in which the value is added to 
65536. The VARPTR function is used when an address in memory with 
data is transferred to a machine language subroutine for example. 


Execution example 
10 A%=15 
20 X=VARPTR (A%) 
30 MS=HEXS$ (X) :PRINT MS 
RUN 
C032 


This program checks the address in memory where the value assigned 
to a variable (A%) is stored, and displays it after converting it to hex- 
adecimal. 
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VPEEK video RAM peek) 


Reads data in the video RAM. 








FORMAT 
VPEEK (address) 
Address Integers from 0 to 16383. 


FUNCTION AND UTILIZATION 

Gives data written at a specified video RAM address. Since the base ad- 
dress of each table can be found by the BASE function, use the BASE 
function to check the video RAM address when the VPEEK function is 
used. 


oe VPOKE video RAM poke) 


Writes 1 byte data to video RAM. 








FORMAT 


VPOKE address, expression 

Address Integers from 0 to 16383. 

Expression Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 


FUNCTION AND UTILIZATION 

Writes arbitrary data to a specified video RAM address. In regard to the 
video RAM address map, since the base address of each table can be 
found with the BASE function, check the video RAM address with the 
BASE function when a VPOKE statement is used. 





FORMAT 


WAIT port number, expression 1 [, expression 2] 
Port number, expression 1, expression 2 
@IrEB Numeric type constants, variables, array variables, 
their expressions from 0 to 255. 


FUNCTION AND UTILIZATION 

When a WAIT statement is executed, data is input from a specified 1/O 
port and XOR (exclusive OR) with the value of expression 2 is given, then 
AND (logical product) of the result and the value of expression 1 is given. 
If the value obtained as explained above is 0, data from the 1/O port is 
continuously input and if it has a value other than 0, an advancement is 
made to the next line number. If expression 2 is omitted, its value is con- 
sidered to be 0. 


Ee WIDTH with) 








FORMAT 
WIDTH (number of characters) 
Number of characters Integers from 1 to 40 in the Screen 0 text mode. 
Integers from 1 to 32 in the SCREEN 1 text mode. 


FUNCTION AND UTILIZATION 


Execution example 


SCREEN O 
WIDTH 40 


In the SCREEN 0 text mode, 40 characters are set per line. 









1-2 SPECIAL VARIABLES AND 
FUNCTIONS 


FORMAT 
BASE (N) 
BASE (N)=expression 
N Integers from 0 to 19. 

Expression Integers from 0 to 65535. 


BASE (base) 





FUNCTION AND UTILIZATION 
Used to read or rewrite a VDP table base address in memory. 


BASE (N) corresponds with the base addresses shown in the table below 


depending on the value of N. 























Value of N Table 

0 40 characters x 24 lines text mode pattern 
name table. 

2 40 characters x 24 lines text mode pattern 
generator table. 

5 32 characters x 24 lines text mode pattern 
name table. 

6 32 characters x 24 lines text mode color table. 

vi 32 characters x 24 characters text mode pattern 
generator table. 

8 32 characters x 24 characters text mode sprite 
attribute table. 

9 32 characters x 24 characters text mode sprite 
pattern table. 

10 High resolution graphic mode pattern name 
table. 

11 High resolution graphic mode color table. 

12 High resolution graphic mode pattern 
generator table. 

13 High resolution graphic mode sprite attribute 
table. 

14 High resolution graphic mode sprite pattern 


table. 




















Value of N Table 
15 Multi color mode pattern name table. 
7 Multi color mode pattern generator table. 
18 Multi color mode sprite attribute table. 
19 Multi color mode sprite pattern table. 





N=1, 3, 4, 16 are not used. 





Precautions 


The register contents and the table base address of the TMS9918A, 
which is the screen display LSI, can be directly modified by using a BASE 
variable and a VDP variable. However, adequate knowledge of the 
TMS9918A is required to perform this. If the base address is carelessly 
rewritten, a normal screen display can not be performed. Therefore, 
precautions shall be taken. 

















MAXFILES (maxfiles) | 





Declares the number of files that can be simultaneously opened in one 
program. 





FORMAT 
MAXFILES=expression 


Expression {rag Numeric type constants, variables, array variables, their 
expressions from 0 to 15. 


FUNCTION AND UTILIZATION - 
Declares the number of files that can be-simultaneously opened in one 
program. Opening files simultaneously means to open a file and open 
another file before closing the former. 


Execution example 


10 MAXFILES=3 

20 OPEN ”“GRP:” FOR OUTPUT AS #1 
30 OPEN ”“CRT:” FOR OUTPUT AS #2 
40 OPEN ”“LPT:” FOR OUTPUT AS #3 


1000 CLOSE 


Since 3 was selected as the number of files that can be opened in line 
10, 3 files can be opened in line 20 and after. 


When the number of files is not specified by a MAXFILES=statement, 
only one file can be opened at one time. 

elf a large value is unnecessarily declared, the user area becomes 
smaller. 





ISPRITES (sprite dollar)” 


Defines sprite pattern data. 








FORMAT 
SPRITES (sprite number) 
Sprite number @yy_ When 8x8 dots—Integers from 0 to 255. 
When 16 x 16 dots—Integers from 0 to 63. 


FUNCTION AND UTILIZATION 


When the sprite pattern is defined for the SPRITE$ variable, it is main- 


tained as a specified sprite number pattern. See “2.2 Screen configura- 
tion and graphics” for definition details. 













































































TIME time) | 


Holds the value of a built-in timer. 











FORMAT 
TIME 
TIME=expression 
Expression Constants, variables, array variables, their expressions 
from 0 to 65535. 


FUNCTION AND UTILIZATION 

In regard to this variable, the value of a built-in timer is held during BASIC 
activation with the value advanced by 1 about every 1/50 second ina 
range from 0 to 65535. When 65535 is reached, it becomes 0 again. 
The value of the variable can be rewritten with a LET statement. When 
the CPU is in an interrupt prohibition state (such as during cassette tape 
/O), this timer is stopped. When the power is off, it does not operate. 


Execution example 


10 CLS: TIME=0 

20 LOCATE 12,8:PRINT INT (TIME/SO) 

30 GOTO 20 
This program continuously displays the integer of the value, in which the 
value of TIME is divided by 50 after making the TIME variable value be- 
come 0 once. The numeral is advanced by 1 about every second. 
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FORMAT 


VDP (register number) 

VDP (register number)=expression 

Register number Integers from 0 to 8. 

Expression Constants, variables, array variables, their expressions from 
0 to 255. 


FUNCTION AND UTILIZATION 

Used as a function to read the register content of the TMS9918A (VDP), 
the video display LSI of the MSX personal computer, or as a variable to 
write data directly to the register. 


VDP registers 
Followings are the bit assignment of the VDP registers. 











Register 0 
MSB 7 6 5 4 0 LSB 
| (6) (6) | (6) | ) | 0 | M3 
External video signal 
(Input if 1) 
Mode selection bit 3 
Register 1 
MSB_ 7 6 al ; 3 0 LSB 
4/I6K BLANK| IE ] M2 | 0 SIZE MAG 





Sprite magnification 
(magnification if 1) 


poe size (8x8 if 0) 
Mode selection bit 1, 2 
Interrupt output specification 
Screen display ON/OFF (display if 1) 
4K/16K byte memory selection (4K if 1) 





Register 2 MSB_7 6 5 4 3 2 file 0 LSB 
Pattern name table 
o : | 0 | 7 | base address | 














Pattern name 






























































table address [As An| Au| Ac As As Ac | As} Aa | As A | Ao 
400H0 00 100000000 
Register 3 MSB_7 6 5 wa ce 2 1 0 LSB 
Color table — address | | 
As|As| Az] As | As| As | As | Ac a.[A 
{f 1 41-0 -O OG O30. Oo <0 
Register 4 MSB 7 6 5 4 ‘ 2 1 : LSB 





Pattern generator 
base address 


oo LSB 








Pattern aaa pee 


















































table address [as Ar} Au [As] As | As 
800H 0 O 1 O ie} 
Register 5 MSB 7 6 5 4 3 : 2 i 0 a 
(e) | Sprite attribute saa base adgress 
Sprite attribute ae 
table address marr Au [An As | As | A; As 




















a uA PS 


Register 6 MSB 7 6 5 4 3 1 0 LSB 
T 
fe) | 0 | ) | ° | 0 | Sprite sae table | 














B 





Sprite generator MS 
table address Ais| Ar 


OOOOH O O O 





Aw As | As | Az 2| Ai} Ao 





























As As Aa 
0 0 0 
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Register 7 
MSB 7 6 5 4 3 2 1 0 LSB 
T T T 
Text eqier way Text anes da drop color 
16 color codes from OH to FH. 
Register 8 MSB_7 6 5 4 3 2 1 0 LSB 











F 5S | Cc 5th sprite No. | | 











5th sprite No. 
Overlap flag 
5th sprite a 


Interrupt flag 


Register 8 is a read-out dedicated status register while the other 
registers are write-in dedicated. 


Precautions 


To accomplish screen operation with a VDP variable and by rewriting the 
VDP register value, adequate knowledge of the TMS9918A is necessary. 


If the VDP register is carelessly rewritten, thé’screen display is not cor- 
rectly performed. Therefore, precautions shall be taken to avoid this. 











1-3 ERROR MESSAGES 


When an error occurs, program execution is stopped, a command wait 
status occurs, and an error message is displayed. The cause of an error 
is concisely displayed as an error message. Error messages and actual 
examples of error causes are explained below. The numerals inside 
parentheses are error numbers. 


Bad file name (56) 
@File name is improper. 

@A device name that cannot be specified by an OPEN, SAVE or LOAD 
statement, was specified. 





Bad file number (52) 
@A file number was used that exceeds the range specified by a 
MAXFILES=statement. 

@ PRINT # statement execution was attempted with an unopened file 
number. 








Can’t CONTINUE (17) 
e@After an interruption, program was attempted to be restarted after 
modification. i 

@A program does not exist. & 

@A CONT statement was used in a program. 











Device I/O error (19) 
e@Load prevented due to cassette tape or tape recorder. 
@ Improper tape recorder level. 

@Command interrupted before load completion. 

@1/O unit error. 


Direct statement in file (57) 
@A statement in an ASCII program being loaded does not have a line 
number. 

@An attempt was made to load a file other than that of a BASIC program 
(such as a data file). 





Division by zero (11) 
@ Execution of division by zero was attempted. 
@ Execution of division by an undefined variable was attempted. 





File already open (54) 
@An attempt was made to reopen an opened file. 





File not OPEN (69) —2—M 
@ Execution of aPRINT# or INPUT # etc. statement was attempted by us- 
ing a file number that was not opened by an OEPN statement. 


ie ve] 


Illegal direct (12) 
@Execution of a statement that can only be used in a program, such as 
a DEFFN statement, was attempted by a direct command. 








Illegal function call (5) 
@A wrong value was used in a command. 
@ Value of a function is outside the tolerance range. 





Input past end (55) 
@Although all file data was read, read was attempted again. 
@A file does not contain data. 





Internal error (51) 
@ BASIC interpreter is abnormal. 








Line buffer overflow (25) 
@ Input line buffer is full. 








Missing operand (24) 
@No parameter exists after a command. 
@Required parameters are incomplete. 





NEXT without FOR (1) 
@An executed NEXT statement has no corresponding FOR statement. 
@ Execution was transferred by a GOTO statement to somewhere inside 
a FOR—NEXT loop. 





NO RESUME (21) 
@An error processing routine has no RESUME statement. (An error 
processing routine must end with END, RESUME, or ON ERROR GOTO 0.) 





Out of DATA (4) 
@During READ statement execution, either no data or insufficient data 
exists. 


Out of memory (7) 

@Program too long. 

@Too many variables used. 

@ Array too large. 

@The multi-structure of a FOR—NEXT or GOSUB—RETURN statement 
is too long. 





Out of string space (14) 
@Character area is exceeded. 
@ The character area specified by a CLEAR statement is too small. 


Overflow (6) 
@ Numeric type data or an arithmetic result exceeds the range that can 
be handled. 

@An address parameter is outside a specified range. 





RESUME without error (22) 
@A RESUME statement has no corresponding ON ERROR statement. 
@A transfer to an error processing routine by a GOTO statement. 
@Since no END statement exists at the end of a main routine, an error 
processing routine is continuously executed. 





RETURN without GOSUB (3) 
@A RETURN statement has no corresponding GOSUB statement. 

@ Transfer to a subroutine by a GOTO statement. 

@Since no END statement exists at the end of a main routine, a subrou- 
tine was continuously executed. 








Redimensioned array (10) 
@An attempt was made to define overlapping arrays with the same 
name. 

@Arry variables were used without being defined by a DIM statement, 
then they were defined. 


String formula too complex (16) 
@A one line character expression is too complicated. 





String too long (15) —2-A- NNN 
@A character variable was assigned a value that exceeded 255 
characters. 


Subscript out of range (9) JH 
@A subscript was used that exceeded the size declared by a DIM 
statement. 

@A subscript exceeding 11 was used for an array variable not declared 
by a DIM statement. 


Syntax error (2) 
@An input statement is not in accordance with MSX-BASIC grammer. 








Type mismatch (13) 
@The types of the left and right sides of LET statement are different. 
@A logical operation was attempted to string type data. 

e@The type of data specified by a function is a mismatch. 
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Undefined line number (8) 
@A non existing line number was specified in a GOTO, GOSUB, or RE- 
SUME statement. 

@At RENUM statement execution, a non existing line number was speci- 
fied with a GOTO statement etc. 





Undefined user function (18) 
@An attempt was made to use a user function not defined by a DEFFN 
statement. 


Unprintable error (23, 26-49, 60-255) 





@An error occurred that has no error number. 
@An error occurred because the number of an unprintable error was 
specified in an ERROR statement. 





Verify error (20) 
@ The program on cassette tape is different from the program in memory. 














CHAPTER 2 











MSX-BASIC UTILIZATION 





2-1 OPERATION MODE 


After MSX-BASIC activation, “Ok” is displayed and the cursor appears 
below. The state that occurred with the cursor located on the left after 
MSX-BASIC activation and the display of “Ok”, is called a command wait 
state. Also, the command wait state occurs when a program is interrupt- 
ed by a STOP statement or when the |cTRL| and |Stop} keys are simul- 
taneously pressed, in the state after execution has been terminated, or 
when a direct command has been terminated, besides the state after 
MSX-BASIC activation. The wait state indicates that a computer awaits 
your command input. 




















DIRECT COMMAND MODE 

A command is directly input during the command wait state. At that time, 
MSX-BASIC immediately executes a command and returns to the com- 
mand wait state. 


INDIRECT COMMAND MODE 

A statement consisting of one or more commands is input with a line 
number in front of it. At that time, MSX-BASIC does not immediately exe- 
cute the statement but stores it with the line number and returns to the 
command wait state. When RUN or GOTO statement is executed, state- 
ments stored in memory are sequentially executed with their line num- 
bers, and after execution is terminated, the command wait state occurs 
again. 


2-2 FULL SCREEN EDITOR 


The full screen editor is used to perform modification, addition and col- 
lection of characters by moving the cursor to an arbitrary screen loca- 
tion. Program preparation or correction can be easily performed with this 
function. 

The full screen editor can be used for all the characters displayed on the 
screen during the direct command mode in which a line where the cursor 
is located is input to the computer when the |RETURN]| key iS pressed. 
When the beginning of a line is a numeral, the line is stored in memory 
as a line of a program, and when it is not a numeral, the line is immedi- 
ately executed. 

In this case, the line is interpreted as one that is punctuated by the 
RETURN | key. This is not required for one line on the screen but might be 
required for several lines. (The maximum length per line in MSX-BASIC is 
255 characters.) 














EDIT KEY UTILIZATION 





Key Function 





Cursor move keys Moves the cursor by one space up, down, left 
(pB wax q) and right. 
































HOME Moves the cursor to the extreme top left of the 
screen. 

SHIFT| + |HOME Clears all characters on the screen and moves 
the cursor to the extreme left top of the 
screen. 

INS Provides insert mode entry (the cursor 


becomes small). After this, characters input by 
the keyboard are inserted at the cursor 
location. 


Press the [Ins] key again, key or 


cursor move key to return to an ordinary mode. 











DEL Erases the character where the cursor is 
located. The following characters move to the 
left by one character. 











[Bs | Erases the character just before the cursor. 
The following characters move to the left by 
one character. 








TAB Advances the cursor to the next tab position, 
and if there are characters in between, 
provides a space. 
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KEY FUNCTIONS 
In addition to the edit key, MSX-BASIC is provided with special functions 
just by pressing the key simultaneously with another key. 





Key pressed 


Function 





[cra] + [8] 


Moves the cursor to the beginning of a word 
(character group punctuated by a space). 
When the cursor,is at the beginning of a word, 
it is moved to the beginning of the word just 
before. 





Releases the input wait state or automatic line 
number generation by the AUTO command to 
return to the command wait state. 















































































































































[cTRL] + [E Provides erasure from the cursor location to 
the last line. 

+ [F] Moves the cursor to the beginning of the next 
word. 

CTRL| + |G Generates a beep sound. 

cTrt| + [H] Same as the key. 

ctr” | + [1 Same as the key. 

cat] + [v Moves the cursor 1 line below. 

ctr] + [k] Same as [HOME]. 

cTat| + [L] Same as + [HOME |. 

cTRL| + [mM] Same as the [RETURN ] key. 

[ctrL| + [Nn] Moves the cursor to a location next to the last 
character in a line. 

[crat | + [R] Same as the [INS| key. 

{ctrL]| + [u] Erases all the characters on a line. 

+ [x] Same as [Setect]. Undefined in MSX-BASIC. 

cTRt| + [\] Same as ¢ . 

[ctr] + [| Same as [esc]. Undefined in MSX-BASIC. 

ctat| + []| Same as B. 

[ctr] + [a] Same as =. 

[ctrt] + =] Same asa. 














2-3 SPECIAL KEYS 


FUNCTION KEYS 

The to keys are called function keys. A certain character string 
can be defined for each function key in which function key depression 
functions the same as entering the character string defined for a func- 
tion key. In MSX-BASIC, the following character strings are defined when 
the MSX-BASIC is activated. 




















[FA | color _. 

[ F2 | auto _. 

F3 goto _. 

LF 4 | list _. 

Fs] run 

SHIFT] + [F1| color 15, 4, 4 [RETURN 














SHIFT F2 cload”’ 











SHIFT F4| _ilist. [RETURN 





























+ 

SHIFT] + |F3 | cont [RETURN 
+ 
+ 











SHIFT F5| [SHIFT] + [HOME] run [RETURN | 





The contents of a function key can be freely redefined by a KEY 
statement. 


OTHER SPECIAL KEYS 
stop | key 


Temporarily stops execution during BASIC program execution. Press this 
key again during stop to resume program execution. 











CTRL| + |STOP | Simultaneous depression 

Interrupts execution during BASIC program execution. When line num- 
bers are automatically generated by an AUTO statement, the command 
wait state occurs. 


key and [E56] key 


These keys are undefined in MSX-BASIC (no function). 
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2-4 SCREEN CONFIGURATION AND 
GRAPHICS 


SCREEN CONFIGURATION 
The display screen configuration for MSX-BASIC is as shown below. 





Border area 


Background 


Foreground 





Sprite plane (32 planes from 0 to 31) 


Text mode and graphic mode 

The text mode displays characters (alphanumeric characters), and the 
graphic mode displays graphics (dots, lines, circles, etc.). MSX-BASIC in- 
cludes two text modes and two graphic modes that are selected by a 
SCREEN statement: 


Screen mode 
The modes selected by a SCREEN statement are as follows. 











peneeN Mode Puts Characteristics 
statement plane 
SCREEN 0 40 characters max.jCan’t |Width per character is 
(This mode horizontal, 24 linesjbe 6 dots. Since the width 
is selected vertical. used of a part of graphic 
when BASIC characters is 8 dots, 
is acti- they can not be 
vated.) ae completely displayed. 
SCREEN 1 ia 32 characters max.|JCan —_|Width per character is 
horizontal, 24 linesjbe 8 dots. Since most 
vertical. used_ |characters use only 6 


dots, the display 
characters are read 
more easily compared 











to SCREEN 0. 
SCREEN 2 256 x 192 dots high)Can be/Graphics are drawn 
resolution mode |used_ |with 1 dot units. 
Graphic 
SCREEN 3 256 x 192 dots Can bejGraphics are drawn 
multi color mode |used_ [with block units of 


4x4 dots. 




















The foreground, background, and border area are used in any mode. With 
characters or graphics displayed in the foreground, only color can be 
changed for the background and border area. 

Also, the sprite planes can be used in addition to the above in modes 
other than the SCREEN 0 mode. A sprite plane is a plane on which a dy- 
namic picture can be displayed by using freely defined sprite patterns 
which will be explained in the “Sprite utilization” section. 


Color specification 
A COLOR statement specifies the color of the foreground, background, 
and border area. 


COLOR foreground color, background color, border area color 


Both characters and graphics are displayed with the color specified for 
the foreground color, unless specifically specified. 

Also, in the SCREEN 0 mode, the color of the border area is always the 
same as that of the background. 

See page 194 for color codes. 








HIGH RESOLUTION GRAPHICS—SCREEN 2 MODE 
Graphics canbe drawn with the following commands in a graphic mode. 


PSET, PRESET ... Marks a dot or erases it. 


LINE ... Draws a straight line or square. 
CIRCLE ... Draws a circle 

PAINT ... Colors 

DRAW ... Draws arbitrary graphics. 


When these commands are used, screen coordinates are set to specify 
the screen location. 


Gow-258 1 255 


o —~ 
~~ 
aia 
191 


In the high resolution graphic mode, the location and color can be speci- 
fied for each dot with 256 dots arranged vertically and 192 arranged 
horizontally as shown in the above figure. 

However, if each specified color is restricted to 8 horizontal dots, only 1 
color can be specified, and the color specified last is valid. 























won- oO 












































10 SCREEN 2 
20 LINE (9,50)-(14,50),15 
30 LINE (12,40)-(12,60),1 
40 GOTO 40 






1 block 1 block 


In the above program, with horizontal block coordinates from 8 to 15, 
although the color was specified as white, the straight line drawn by line 
20 is displayed as black because the black line drawn next overlaps this 
line. 

The specification of white becomes valid when the LINE statement in 
line 20 is changed as follows. 


LINE (8,50)-(15,50) 


This allows a maximum horizontal line to be drawn in the block of 8 dots. 


MULTI COLOR GRAPHICS—SCREEN 3 MODE 

Graphics can also be drawn in the SCREEN 3 mode by using a graphic 
command such as aPSET or LINE statement. Also, the location can be 
specified by utilizing 0-255 horizontal and 0-191 vertical coordinates. The 
unit for drawing graphics is a 4x4 dot block. 


0123 4567 89 10 11121314 15 








NO OH WN AO 

















PSET (12,4),1 
PSET (14,5),1 
PSET (15,7),1 


For example, since the above statements specify 1 dotin the same block, 
the ® part of the above figure is colored black by using any of them. 


LINE (17,5)-(130,110) 


This LINE statement draws a rough line to connect blocks that include 
128 131 


17, 5) and (130, 110), or in other words to connect «7 woe 
(17, 5) ( ) eal ene lls 





STEP SPECIFICATION 

To specify coordinates (X, Y), the STEP (X, Y) specification can be per- 
formed by CIRCLE, LINE, PAINT, PSET, PRESET, and PUT SPRITE 
commands. 

When these graphic commands are executed, the dot specified last is 
memorized by MSX-BASIC. After this, when STEP (X, Y) is specified next, 
the location of (X, Y) is determined on a new coordinate system with a 
dot specified last as the origin (0, 0). However, if STEP is omitted, the lo- 
cation can always be specified on the ordinary coordinate system using 
the extreme top left of the screen as the origin. 


Example 1 


10 SCREEN 2 

20 PSET (50,50) 

30 LINE STEP (60,-40)-(150, 100) 
40 GOTO 40 


In this program, the coordinates (50, 50) specified when the PSET state- 
ment was executed are memorized in line 20 then the program advances 
to line 30. Since STEP (60, — 40) is used as a specification for the LINE 
statement starting point, the new starting point is a location that is 60 
toward X and — 40 toward Y with (50, 50) as a new origin. 








(150,100) 








Example 2 


10 SCREEN 2 

20 FOR I=30 TO 240 STEP 20 
30 LINE (120,10)-(1,150) 
40 CIRCLE STEP(0,20) ,20 

50 CLS 

60 NEXT I 





In this program, although the LINE statement end point coordinates in 
line 30 are changed by the repetition of a FOR-NEXT loop, the center of 
the circle is specified by STEP (0, 20) inthe CIRCLE statement of line 40, 
and the center of the circle is always determined to be a certain distance 
from the origin which is the end point of a straight line. 


STEP (0,20) 





HOW TO USE THE SPRITE PATTERN 
In MSX-BASIC, a pattern (called a sprite pattern) with a freely defined for- 
mat is displayed as one of 32 sprite planes and can be moved. 


Sprite patterns 

A sprite pattern consists of 8x8 or 16x 16 dots for which two different 
sizes (magnified or unmagnified) can be selected. The magnified size is 
twice as big as the unmagnified size both horizontally and vertically. 


















































8x8 dots unmagnified 


















































8x8 dots magnified 






































16x 16 dots magnified 
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The size of a sprite pattern is determined by a SCREEN statement. The 
2nd parameter of a SCREEN statement selects the sprite size. 

















Parameter Sprite size 
0 8x8 dots unmagnified 
1 | 8x8 dots magnified 
2 16 x 16 dots unmagnified 
3 16 x 16 dots magnified 














SCREEN 2,2 


This statement specifies that a 16 x 16 unmagnified sprite is used in the 
high resolution graphic mode. The sprite size displayed on all sprite 
planes remains constant once the sprite size is specified by a SCREEN 
statement. 


Sprite pattern definition 

When a 8x8 dot pattern is defined, the pattern is first separated by 8 
lines horizontally. For example, an arrow pattern is defined as shown in 
the following figure. 




















When this pattern is separated into 8 horizontal lines, it is divided into 
small patterns that consist of 8 dots. 


[|] Mi [1 
[| a | 














LT | Mm TT | 
Ll 1 Mi TT 
Ll | Ma {I 
Li | i [1 


Next the pattern in each line is arranged with 1 used to mark a dot and 
0 used to indicate an unmarked dot which results in a binary number. For 
example, the top line is 00011000, and the next line is 00111100. 


CTT MTT) <> = [elelols Fs Tofofo) 
(| i |) > [ofols TT Tol} 





ake}s) 


The binary numerals realized as mentioned above are converted to hex- 
adecimal (or decimal). For the top line, 00011000 (binary)=18 (hex- 


adecimal) or 24 (d 


ecimal). 


For the second line, 00111100 (binary) =3C (hexadecimal) or 60 (decimal). 
It is easier for the user who is unaccustomed to convert binary to hex- 
adecimal to divide the 8 dot pattern into 4 dots on the left and 4 dots on 
the right to convert to one hexadecimal digit (O—F) by referring to the fol- 
































lowing table. 

Pattern Hexadecimal | Pattern | Hexadecimal 

LI ( 0 | ae 8 

| wi 1 | 9 

[| 2 | A 

|_| 3 a ie B 

| a 4 Zl C 

| 5 ha = D 

| 6 mz | E 

| 7 Sa F 


























pattern, left 4 dots is 














i and right 4 





With in) 
dots is ae _|. Therefore, they are converted to hexadecimal 18 based 


on the above table. 
The character, for which hexadecimal (or decimal) is the character code, 
is obtained by using the CHR$ function. The definition of the sprite pat- 
tern explained above is arranged as follows. 


Pattern to be defined 
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P, Mil is 
jaf 
(7 oo 
—- im 
moe a eapeste 
oo 
~~ mec « 

| —— 18 














CHRS (&H18 
CHR$ (&H3C) 
CHR$ (&H7E 
CHR$ (&HFF) 
CHRS (&H18 
CHRS (&H18 


CHR$ (&H18) 





atest ueeavest 


CHR$ (&H18 











In regard to the 8x8 dot sprite pattern, the character data obtained as 
shown above is added sequentially from the top and is assigned to the 
SPRITE$ variable as a character string which defines the sprite pattern. 
For the arrow pattern in the above example, it is defined as follows. 


SPRITES (1) =CHRS (&H18) +CHRS (&H3C ) +CHRS (&H7E) 
+CHRS$ (&HFF ) +CHRS (&H18) +CHRS (&H18) +CHRS (&H18) 
+CHRS (&H18) 


The number of the defined sprite pattern is 1 and is indicated by the 
numeral 1 inside the parentheses of SPRITE$ (1). 


Also, if a character exists that can be obtained with the CHR$ function, 
it can be directly used. In the above example, since CHR$(&H3C) is “<“ 
and CHR$(&H7E) is “~’, it can be defined as follows. 


SPRITES (1) =CHRS (&H18) +” <7 +" ~" + CHRS (&HFF ) + 
CHRS$ (&H18) +CHRS (&H18) +CHRS (&H18) +CHRS (&H18) 


A 16x16 dot sprite pattern can be defined with the same procedure. 
However, a 16 x 16 dot sprite pattern is considered to be a collection of 
four 8x8 dot sprite patterns, and these four patterns are defined after 
putting them together in the sequence shown below. 


8 











16 





16 

















AS=CHRS$ (&HO ) +CHRS (&HO) +CHRS (&H18) +CHR $ (&H3C) 
+CHRS (&H3C) +CHRS (&H18) +CHRS (&HO4) +CHRS (&H22 ) 
BS=CHRS (&H1LA) +CHRS (&HO6) +CHRS (&HOF) + 

CHRS (& HOF) +CHRS (&HO7) +CHRS (&HO7 ) +CHRS (&HO3) 
+CHRS$ (&HO3 ) 

CS=CHR $ (&HOC) +CHRS (&H1LE) +CHRS (&H33) + 

















CHRS (&H33) +CHRS (&HLE) +CHRS (&H2C ) +CHRS (&H20) 
+CHRS (&HSC) 

DS=CHR $ (&HS8 ) +CHRS (&HAO ) +CHRS (&HFO ) + 

CHR $ (& HF O) +CHRS (&HEO) +CHR $ (&HEO) +CHRS (&HCO) 
+CHRS$(&HCO) 

SPRITES (2) =AStBStC$+DS 
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Number of sprite patterns that can be defined 

The numbers of 8x8 dot sprite patterns are from 0 to 255, and those of 
16 x 16 dot sprite patterns are from 0 to 63. In other words, up to 256 8x8 
dot sprite patterns can be defined, and up to 64 16 x 16 dot sprite patterns 
can be defined. (However, this is sometimes restricted depending on the 
memory capacity.) 


Sprite pattern display 


A PUT SPRITE statement is used to display a defined sprite pattern on 
a sprite plane. 


PUT SPRITE sprite plane number, (X-coordinate, Y-coordinate), 
color code, sprite pattern number. 


To display a sprite pattern defined by the above at location (120, 80) of 
sprite plane 0 with green (color code 2), the program is as follows. 


PUT SPRITE O, (120,80) ,2,1 
The specified display location is a dot on the left top of the sprite pattern 


frame. The X, Y-coordinates are specified using a coordinate system with 
(0, —1) on the graphic screen as the origin (0, 0). 


on Sprite plane 0 
(120,80) 





— Green 
\ 


\ 
Sprite pattern 1 











PUT SPRITE 0, (120, 80), 2, 1 


Sprite pattern display rules 
@Only one sprite pattern can be displayed on one sprite plane. 
@When sprite patterns overlap on different sprite planes, the sprite 
pattern on the sprite plane at the back (larger number) is hidden by the 
sprite pattern in front. 
@When five or more sprite patterns are arranged horizontally, up to 
four sprite patterns with a higher priority (on sprite planes with 
smaller numbers) are displayed. 
@When the display location specification is omitted, it is considered 
that the location has been specified by a previous graphic instruction. 
@When the color code is omitted, it is considered that the foreground 
color has been specified. 
@When a sprite pattern number is omitted, it is considered that the 
same number as the sprite plane number has been specified. 











To move a sprite pattern 

To move a sprite pattern, replace the X and Y-coordinates of the display 
location specified by a PUT SPRITE statement with a variable, then exe- 
cute the PUT SPRITE statement repeatedly by changing the value of the 
variable. Since the previous sprite pattern on a sprite plane disappears 
when a PUT SPRITE statement has been executed once, it is unneces- 
sary to erase it in a program. 

Also, since a pattern can be moved in 1 dot units, the movement is 
smooth. 

In the following program, a UFO-shaped sprite pattern flies about on the 
screen by changing its direction. 


10 SCREEN 2 

20 SPRITES (0) =CHRS (&H3C) +CHRS (&H7E) +CHRS( 

&H8 1) +CHRS$ (&H8 1) +CHRS (&HFF ) +CHRS (&H7E) +C 
HR$(&H 24) +CHRS (&H42) 

30 X=100:Y=100 

40 S=INT (RND (1) *80 ) ———————Determines the movement distance. 
50 D=INT (RND(1) *4) 

60 IF D=0 THEN VX=0:VY=-1 

70 IF D=1 THEN VX=1:VY=0 

80 IF D=2 THEN VX=0:VY=1 

90 IF D=3 THEN VX=-1:VY=0 

100 FOR I=0 TO S$ 

110 PUT SPRITE O,(X,Y),1,0 

120 X=X+VX:Y=Y+VY 

130 IF X>240 OR X<O THEN VX=-VX 
140 IF Y>175 OR Y<O THEN VY=-VY 
150 NEXT I 

160 GOTO 40 


Determines the direction. 





Moves the sprite. 
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2-5 SOUND 


MSX-BASIC AND SOUND 

MSX-BASIC is provided with two music performance commands which 
are PLAY and SOUND. PLAY is acommand that performs as specified by 
a subcommand using the LSI that controls pitch, rhythm, and timbre. 
Sound is output by writing several different data items into the LSI 
register. Specified data can be written directly to the LSI register by a 
SOUND statement. Therefore, a program that directly controls the sound 
with a SOUND statement can be prepared by knowing the function of the 
LSI sound register and the data to be written in. 


CONTROL OF VOLUME VARIATIONS WITH A PLAY STATEMENT 
Although the utilization of the PLAY statement is covered in the Chapter 
1 PLAY section, the S subcommand and M subcommand can be ex- 
plained as follows. 


PLAY ”"CDEFG” ———————@ 


PLAY ”“S13M255CDEFG+——-® (Each _ is a subcommand.) 


Execute @ first and @ next in BASIC, and compare these two statements 
which have the same timbre. 
When you execute 


PLAY ”“S8MS00CDEFG” 


it sounds as if a piano is being continuously played at high speed. 
Sn —Subcommand that selects the volume variation pattern. 
Mn—Subcommand that determines the cycle of the pattern selected 
by Sn. 
The initial values of Sn and Mn are S13 and M255 respectively. A different 
timbre can be generated by changing the value of n for Sn and Mn. 


Pattern and cycle combinations 

There are 8 patterns that can be selected by the S subcommand as 
shown in the table on page 88. The cycle becomes shorter as the value 
of n is minimized by the M subcommanad. (In other words, the pattern 
repetition number in a certain period of time becomes larger.) 

This can be proved by executing the following statement. 


PLAY ”S8M300ICDEFG” 


Let’s listen to the following two statements and compare them. 
PLAY “BSM900CDEFG” 


PLAY “S10M900CDEFG” 


Now the difference in the patterns specified by the S subcommand is 
clear. However, if the value of n becomes too large in the M subcom- 
mand, the cycle becomes too long. Therefore, sometimes the difference 
is not clear. 


PLAY ”“S8M6000CDEF G” 


PLAY ”S1O0M6000CDEFG” 


When these two statements are executed, they both sound the same be- 
cause the pattern was stretched horizontally (period) too long, and when 
the scale is played, the matching parts of different patterns are only 
used. 


Pattern S8 = M~.L_ 
ie Sts 
S8M6000 ~S / 4 
! 
! 





Part actually played 


ye Pattern S10 


S10M6000 ~d 





Part actually played 


Since the length of the part actually played in the above figures is 
changed by the Lsubcommand specification, many enjoyable music per- 
formance programs can be prepared by skillfully selecting the right com- 
binations. 
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SOUND AND NOISE WITH A SOUND STATEMENT 

SOUND is a command that generates arbitrary sound or noise by writing 
data to a sound LSI register called a PSG (Programmable Sound Genera- 
tor). The PSG is provided with 3 channels that generate sound (with a cer- 
tain frequency). Noise can also be applied to all these channels. So the 
generation of triple chords and noise is possible. The PSG is provided 
with 16 registers which have different functions. 



































Register No. Function 
0, 1 Determines the frequency of channel A. 
2,3 Determines the frequency of channel B. 
4,5 Determines the frequency of channel C. 
6 Determines the noise frequency. 
7 Selects a channel. 
8 Determines the volume of channel A. 
9 Determines the volume of channel B. 
10 Determines the volume of channel C. 
11, 12 Determines the cycle of the volume 
variation pattern. 
13 Selects the volume variation pattern. 














(Registers 14 and 15 have no relationship with the musical performance.) 


The register is a place where data is temporarily stored. The sound 
generated in the PSG is changed depending on the data written in the 
registers. 


Sound frequency determination 

The frequencies generated by the 3 different channels are determined by 
using 6 registers from 0 to 5. Data written in the registers can be obtained 
with the following expression. 


1996750 (Hz) 
16 x (output frequency (Hz)) 





= 256 x (register 1, 3, 5 data) 
+(register 0, 2, 4 data) 


For example, when 300 Hz sound is to be generated from channel A, the 
following expression is realized. 


1996750 


6x 300 +416 =256 x 1+160. 


Therefore, write 160 to register 0, and 1 to register 1. 
The actual statements are as follows. 


SOUND 0,160 
SOUND 1,1 


In the case of channel B, since register 2 and 3 are used instead of 
register 0 and 1, the statements are as follows. 


SOUND 2,160 
SOUND 3,1 


Noise frequency determination 
Data from 0 to 31 can be written in register 6 which determines the noise 
(zoo sound) frequency. The following relational expression is realized be- 
tween the data and frequency. 


1996750 (Hz) 


Data value= 
ata value 16 x noise frequency (Hz) 





For example, when data 15 is written to register 6, 


15 1996750 
~ 16 x 8320 
Therefore, the noise frequency is about 8320 Hz. 


Channel specification 
The channel used is determined by the data written in register 7. 











Noise Sound 
Channel 
Cc B A Cc B A 
32 16 8 4 2 1 


























Add the numeric values that correspond to the channel used based on 
the above table and subtract the result from 255 to obtain the data to be 
written. 

For example, when sound is only to be generated from channels A and 
B, and sound and noise from channel C, the following expression is real- 
ized in which 216 is the data to be written. 


255 -(32+4+2+ 1)=216 





Sound generation after volume determination 

Write data that determines the volume of channels A, B, and C to 
registers 8, 9, and 10 respectively. Data from 0 to 15 can be written with 
15 as the maximum volume. 

The conditions required to generate sound are as mentioned above. 
The following program generates three different sound pitches from 
channel A, B, and C. 


10 SOUND a Sete | Channel A frequency as 200 Hz. 
20 SOUND 
30 SOUND 2" 156 Channel B frequency as 800 Hz. 
40 SOUND 3, 
SO SOUND 4, 62 | Channel C frequency as 2000 Hz. 
60 SOUND 5,0 
70 SOUND 7,248 Me 
80 SOUND 8,9 Specifies the sound output from channels A, B, and C. 
90 SOUND 9,10 
Determines the volume of each channel and 
100 SOUND 10,11 generates the sound. 


When the volume of each channel is changed in lines 80, 90 and 100 in 
this program, the sound output from each channel can be distinguished. 
Also, when the program is executed once, the sound keeps generating. 
Press the |cTRL] key and |stop | key simultaneously to stop this. 

Add: 

















65 SOUND 6,3] —————— (Determines the noise frequency.) 


to this program and modify line 70 as follows. 


(Outputs sound and noise from channel A and sound 
from channel B and C.) 





70 SOUND 7,240 
Now sound mixed with noise is generated. 


Sound effect generation by volume variation patterns 

Functions that are the same as the S subcommand and M subcommand 
of a PLAY statement can be performed with a SOUND statement. Volume 
variation patterns are determined by data written to register 13, which is 
the same as the n specification of a PLAY statement S subcommand 
(Sn). 

See the table on page 88 for the n values of corresponding patterns. 


The cycle of a volume variation pattern is determined by data written to 
register 11 and 12 for which the following expression is realized. 


1996750 (Hz) 


Bex cycle (Ha) = 256 x (data in register 12)+(data in register 11) 


For example, when the cycle is set as 10 Hz, write 12 to register 11 and 
3 to register 12 based on the following expression. 


1996750 | 
556540 7 780-286 3+12 





Set 16 as the volume of the channel in which the pattern specified above 
is to be used. For example, when the volume variation is to be applied to 
channel C, the statement is as follows. 


SOUND 10,16 


Many different sound effects can be generated by applying the volume 
variation pattern mentioned above to the noise, and by mixing the sound 
(tone) with a very high frequency and sound with a low frequency to 
generate a metallic sound or humming. 
The following program generates the sound of a steam locomotive by 
periodically changing the noise volume. 


10 FOR I=6 TO 13 








20 READ J 

30 SOUND I,J 

40 NEXT I 

50 DATA 31—————— Noise frequency 

60 DATA 199 Generates noise with channel A, B, and C. 





70 DATA 16,16,16 Changes the volume of channel A, B, and C. 
80 DATA 138,2 — Volume variation cycle 12 Hz. 
90 DATA 14————— Volume variation pattern 14. 








2-6 FILE PROCESSING 


FILES AND FILE DEVICES 
Sometimes program data provided in a program as a package is ex- 
changed between a computer and equipment connected to a computer. 


For example, lets consider that you keep a diary. There are several book- 
shelves in your room and a notebook entitled “diary” is on one of the 
book shelves. When you read your diary or write in it, first you go to the 
bookshelf of the subject and remove the notebook entitled “diary.” 


When this is applied to a computer, you are the computer and the con- 
tents of the diary is a program or data. The notebook where the program 
or data is recorded is called a file as far as computer terminology is con- 
cerned. The “diary” title on the notebook is the name given to a file and 
is a file name. The bookshelves are equivalent to connected equipment. 
If the wrong equipment is specified, the subject file cannot be found. 


MSX-BASIC commands have been prepared to allow a file to be ex- 
changed between a computer and four different kinds of connected 
equipment. The four different kinds of equipment are called basic file 
devices. The relationship between a basic file device and a computer is 
as shown in the following figure. There are two different file devices with 
one that only provides output to a file and another that provides both in- 
put and output based on the computer. 






¢ Text mode screen 
¢ Graphic mode screen 








¢ Cassette tape recorder 





File Input/Output with a file can only be performed with a cassette tape 
recorder among the basic file devices of MSX-BAS!IC as shown in the 
above figure. Also, the screen of the monitor TV includes a text mode 
screen and a graphic mode screen. 


Device names 

When file exchanges are made with each file device in MSX-BASIC, a 
command is provided that specifies the file device used. At that time, the 
device name determined by MSX-BASIC is used. 














File device Device name 
Cassette tape recorder CAS: 
Text mode screen CRT: 
Graphic mode screen GRP: 
Printer LPT: 








File names 

A file must have a name with a character string that has up to 6 charac- 
ters starting with an alphbetical character. If 7 or more characters are 
specified, the 7th character and after are ignored. 

Although a file name can be omitted, it is recommended that a file name 
be used to distinguish one file from another when cassette tape In- 
put/Output is performed. 


PROGRAM FILES 
The following commands save a BASIC program to a file, load it from a 
file, or combine them. 


CSAVE, CLOAD ... Cassette tape recorder dedicated. 
SAVE, LOAD, BSAVE, BLOAD, MERGE ... Device can be specified. 


When a program in memory is saved on cassette tape, execute: 


CSAVE “PROG1” 
RE Aare, 
File name 


or SAVE “CAS: PROG1” 
See ne 
| 


Device name File name 
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However, a program is saved with an intermediate language format when 
CSAVE is used, and with an ASCII format when SAVE is used. 

A program saved by CSAVE can be loaded by using a CLOAD statement 
by specifying the same file name. Also, a program saved by a SAVE state- 
ment is loaded by a LOAD statement. Besides this, a program can be 
combined with another program that exists in memory by using a 
MERGE statement. However, this cannot be performed for a program 
saved by a CSAVE statement. 

Since LOAD and MERGE statements are used to input a program froma 
file, only CAS: can be specified for a basic device. Also, if a SAVE state- 
ment is executed for the CRT: the result is the same as LIST execution. 
If a SAVE statement is executed for LPT:, the result is the same as LLIST 
execution. 


DATA FILES 
When data to be processed in a BASIC program is exchanged with a 
device, the concept of a file is utilized. 


The following commands are used for data file Input/Output. 


OPEN Opens a file. 

PRINT # ‘ 
PRINT # usine | Outputs data to a file. 
INPUT # ‘ 
LINE INPUT # ; Inputs data from a file. 
CLOSE Closes a file. 


CASSETTE TAPE FILE OPERATION 


Output to a file (Write-in) 

File data output procedures are roughly as follows. 
@ Open a file with an OPEN statement. 

@ Write data to the file with a PRINT # statement. 
® Close the file with a CLOSE statement. 


The format of an OPEN statement is as follows when data is output. 
OPEN “device name [file name]” FOR OUTPUT AS [#] file number 


When this is executed, the set up of data output to a specified device 
with a specified file name is completed for a file. When file Input/Output 
is performed, the computer inputs or outputs data after storing it. The 
area prepared in memory for storing data is called a buffer. Up to 16 
buffers can be prepared in MSX-BASIC. The file number specified by an 
OPEN statement is a buffer that is used from among 16 buffers, in which 
only 1 is specified initially. 


After a file is opened by an OPEN statement, data is actually output by 
a PRINT # statement. 


PRINT # file number, expression [Separator expression] ..... 


The same file number as that specified by the OPEN statement is 
specified. 
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When data is output to a file with a PRINT # statement, a return code 
(&HOD) and a line feed code (&HOA) are automatically written next to 
data. When the data is read, these two codes indicate the puncutuation 
of data. 


When the data is string type, insert “ , ” between each data if several data 
are output with one PRINT # statement. For example, make a statement 
as follows: 


PRINT #1,A$;" , ";BS 


The comma also indicates the punctuation and the data A$ and B$ are 
handled as two separate data when they are input form the file. 
When the data is numeric type, each data is automatically punctuated. 


After data is output, the file is closed by a CLOSE statement. 
CLOSE [#] file number 


After this, since the relationship between the file number and the file is 
released, another file can be opened with the same file number. 


Program example 


10 DIM A$(1,3) 

20 OPEN ”CAS:DATA” FOR OUTPUT AS #1 
30 FOR I=0 TO 1 

40 FOR J=0 TO 3 

50 READ AS(I,J) 

60 PRINT #1,A$(1I,J)57,75 

70 NEXT J 

80 NEXT I 

90 CLOSE #1 

100 END 

110 DATA JAPAN,ENGLAND,FRANCE,U.S.A 
120 DATA TOKYO,LONDON,PARIS,NEW YORK 


When this program is executed, the string type data ‘Japan’, Comma (, ), 
“England” and so forth are sequentially written to cassette tape. The 
data is actually written as follows. 


JAPAN ,ENGLAND, FRANCE ,U.S.A,TOKYO,LONDON, 
PARIS,NEW YORK, 


In line 60, a comma is inserted between data which indicates the punctu- 
ation of data so that the data can be distinguished from other data when 
data is input by an INPUT # statement. 


File input (Read-out) 


The procedure for data input from a file is as follows. 
@ Open a file with an OPEN statement. 
@ Read out data from the file with an INPUT# statement or LINE 


INPUT # statement (Assigns input data to a variable). 


® Close the file with a CLOSE statement. 


The format of an OPEN statement when data is input from a file is as 


follows. 


OPEN “device name [file name]” FOR INPUT AS [#] file number 


The set up for data input from a file is prepared by this. Only fiel No. 1 


can be specified initially. 


After a file is opened, data is read-out by an INPUT # statement. 


Data that is read-out when an INPUT # statement is used is as shown in 


the following table. 





For numeric 
type data 


For string type 
data 





Space, return code, line feed 
code before data. 


Ignored 


Ignored 





Punctuation for data, or when 
data is punctuated. 


Space, comma, 
return code, 
line feed code 


Comma, return 
code, line feed 
code. For 255 

character input. 





When data is inside “ ” 











Items inside 
“ ” are input as 
one data. 





Also, a LINE INPUT # statement is only used for character data read-out 
in which input is performed with a return code as only punctuation for 


data. 


After data input has been terminated, the file is closed by a CLOSE state- 
ment to separate the relationship between the file number and file. 
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Program example 


10 DIM A$(1,3) 

20 OPEN ”CAS:DATA” FOR INPUT AS #1 
30 FOR I=0 TO l 

40 FOR J=0 TO 3 

50 INPUT #1,A$(I,J) 

60 NEXT J 

70 NEXT I 

80 CLOSE #1 

90 FOR J=0 TO 3 

100 PRINT AS(O,J) ,A$(1,J) 
110 NEXT J 


This program is used to read-out a file on cassette tape, named “DATA”, 
prepared in the previous program (lines 20-80) and to display the content 
on the screen (lines 90-110). In line 50, data is continuously assigned to 
the A$ (!, J) array variable. 


10 OPEN ”CAS:DATA” FOR INPUT AS #1 
20 INPUT #1,A$ 

30 PRINT AS 

40 GOTO 20 


What happens if the file called “DATA” is input by using the program 
above? JAPAN, ENGLAND .. are continuously assigned to the A$ charac- 
ter variable and are displayed on the screen. However, after the last data, 
NEW YORK, has been input, the program tries to input continuously 
data. When this occurs although the file has ended, an 


Input past end 


error occurs. To prevent this, the EOF function is used. 


10 OPEN ”CAS:DATA” FOR INPUT AS #1 
15 IF EOF (1)=-1 THEN GOTO 50 

20 INPUT #1,A$ 

30 PRINT AS 

40 GOTO 15 

50 CLOSE #1 


The EOF(file number) function gives —1 when the last file data has been 
read out. In this program, if data remains or not is checked every time 
data is input when this function is used. 


DISPLAYING CHARACTERS ON THE GRAPHIC SCREEN 

When SCREEN 2 or SCREEN 3 is specified by a SCREEN statement, the 
screen enters the graphic mode which does not allow characters to be 
displayed by a PRINT statement. 

To display characters on the graphic mode screen, a method is used in 
which the graphic mode screen is considered to be a file device and 
characters to be displayed are output as a file data. 


10 SCREEN 2 

20 OPEN “GRP:” FOR OUTPUT AS #1 
30 PRINT #1,”How do you do?” 
40 GOTO 40 


When this program is executed, the screen is converted to the graphic 
mode and “HOW DO YOU DO?” is displayed. 

Execute one of the graphic instructions just before to specify the display 
location. After this, the location specified by the instruction last (256 
horizontal, 192 vertical dots) is the top left corner of an 8x6 dot frame 
that holds the first character of the output character string. 


10 SCREEN 2 

20 OPEN “GRP:” FOR OUTPUT AS #1 
30 PRESET (100,50) 

40 PRINT #1.”How do you do?” 

50 GOTO SO 


In this program, the location (100, 50) used by the PRESET instruction in 
line 30 is the top left corner of the character string output in line 40. 


NUMBER OF FILES OPENED ONCE 

Only one file can be specified when MSX-BASIC is initialized. In other 
words, only one file can be opened in one program at one time. When two 
or more files are to be opened at the same time, the number of files are 
previously specified by: 


MAXFILES=5 


Based on this, 5 files with file numbers from 1 to 5 can be simultaneously 
opened. The maximum value that can be specified is 15. 

Also, since file 0 is dedicated to CSAVE, CLOAD CLOAD?, SAVE and 
LOAD, when: 


MAXFILES=0 


is executed, only CSAVE, CLOAD, CLOAD?, SAVE and LOAD commands 
can be used after this. 
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2-7 INTERRUPTS 


An interrupt, used to suspend program flow that began during program 
execution, is caused by the occurrence of a specific external condition, 
and is used to perform other processing. The processing program ex- 
ecuted when an interrupt occurs is called an interrupt processing pro- 
gram or an interrupt processing routine. 


Another concept similar to an interrupt is a Subroutine. However, a 
subroutine is only executed when a GOSUB statement is executed in 
MSX-BASIC. In other words, the execution of a subroutine is previously 
determined internally in a program. 

On the other hand, an interrupt processing routine is executed by an ex- 
ternal condition (for example, when the key is pressed). 


After execution of an interrupt processing routine has been terminated, 
the execution of the main program is normally resumed the same as for 
a subroutine. 


MSX-BASIC INTERRUPTS 

MSX-BASIC is provided with several commands to transfer control to an 
interrupt processing routine when an interrupt occurs. An interrupt can 
be used in the following cases. When an interrupt is used, its utilization 
is first declared by a command, and the starting line number of the inter- 
rupt processing routine is specified. 





An interrupt can be used when: | Interrupt declaration command 





A function key is pressed. ON KEY GOSUB line number 





A space bar, or joystick trigger 


: ON STRIG GOSUB line number 
button is pressed. 














+ |STOP |is pressed. ON STOP GOSUB line number 
Sprites overlap ON SPRITE GOSUB line number 
A certain period of time has 


ON INTERVAL=interval GOSUB line number 











passed. 





For example, 


ON KEY GOSUB 1000 


is a statement that declares when a function key is pressed, it is trans- 
ferred to the routine from line 1000. 


INTERRUPT UTILIZATION 
An interrupt cannot actually be applied by only declaring an ON— 
GOSUB statement. A command that validates the interrupt used must be 


executed 








next. For example, to the interrupt that occurs when the |Fi 





key is pressed, execute: 


KEY (1) ON 


There are five commands that validate interrupts as follows. 












































Command Valid interrupt 
KEY (function key number) ON Interrupt by a function key. 
STRIG (joystick number) ON Interrupt by a space bar, 
joystick. 

STOP ON Interrupt by |ctrL| + [stop | keys. 
SPRITE ON Interrupt by a sprite overlap. 
INTERVAL ON Interrupt with a certain spacing. 
Program example 

10 ON KEY GOSUB 100 

20 KEY(1) ON 

30 SCREEN 2 —_ Main program 

40 LINE (50,50)- (200,150) ,,B 

50 GOTO 40 


100 *SUBROUTINE 
110 BEEP:CLS 
120 FOR I=10 TO 90 STEP 10 


130 CIRCLE (120,100) ,I 





Interrupt processing routine 


140 NEXT I 
150 CLS 
160 RETURN 40 











In this program, when the |F1|key is pressed, it is set so that a transfer 
is made to a subroutine from line 110 in line 10 and 20. 

When this program is executed, a rectangle is continuously displayed by 
line 40 and 50 of the main program. However, when the key is 
pressed, an interrupt occurs to provide a specified transfer to line 100. 
As aresult, the rectangle disappears with a beep sound (BEEP: CLS), and 


9 circles 





are continuously drawn. After the last circle has been drawn, 


the screen is cleared and a return is made to line 40 again. 
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[-—» Interrupt processing routine 


Main program Beep 


la ee 
Ld 


INVALIDATING AN INTERRUPT 
Lets add the following line to the program above. 








105 KEY (1) OFF 











Execute the program. When |F1 |is pressed the first time, an interrupt oc- 
curs. However, it does not occur after this even when the key is 
pressed. 
The reason for this is that when the interrupt processing routine was first 
executed, 


= 





KEY (1) OFF 





on line 105 was executed which invalidates the [F 


= 








key interrupt. 





INTERRUPT HOLD 

When execution is transferred to an interrupt processing routine by an 
interrupt, an interrupt hold state occurs. In this state, when an interrupt 
is applied again, an interrupt does not occur and a return is made to the 
main program by a RETURN statement for which an —ON statement au- 
tomatically occurs, the main program is not executed and a transfer is 
made to an interrupt processing routine soon. 

In other words, during the interrupt hold state, a return is not madetothe 
start line of interrupt processing routine when an interrupt is applied but 
the interrupt application is memorized and an interrupt occurs after com- 
ing out of the processing routine once. 








In regard to the program on page 177, when the key is pressed, 9 cir- 
cles are drawn by an interrupt. However, an interrupt does not occur if the 





[F1 | key is pressed before the last circle is drawn. Then, after the last cir- 
cle has been drawn, a return is made to the main program. However, an 
interrupt occurs due to the second pression of the key and a rec- 
tangle is not drawn, but circles are drawn again. 


| Interrupt processing routine 


Main program Beep The |F1|key is pressed 























during the interrupt 
processing routine. 
> Oo \——me eee > 


Returns to the main program once. 





[|-—> Interrupt processing routine 


Beep 
Interrupt occurs soon. 


VALIDATING AN INTERRUPT DURING AN INTERRUPT 
PROCESSING ROUTINE 

To further validate an interrupt during the interrupt processing routine, in- 
sert acommand such as KEY(1) ON. As a result, the interrupt processing 
routine can be executed from the beginning by applying an interrupt dur- 
ing the interrupt processing routine. 


Program example 


10 ON KEY GOSUB 100 

20 KEY(1) ON 

30 SCREEN 2 

40 LINE (50,50)-(200,150),,B 
50 GOTO 40 

100 _*SUBROUTINE 

[105 KEY(1) ON] 

110 BEEP:CLS 

120 FOR I=10 TO 90 STEP 10 
130 CIRCLE (120,100),1I 

140 NEXT I 

150 CLS 

160 RETURN 40 











itsi@) 


This is the same as the previous program except that the command, 
KEY(1) ON, is inserted in line 105. 


As a result, when the key is pressed again while the circles are be- 
ing continuously drawn by an interrupt, an interrupt occurs immediately 
in which the interrupt processing routine from line 100 is executed from 
the beginning. 


[|-—> Interrupt processing routine bo Interrupt 
processing routine 
Main program Beep Beep 





r 





a ee Oe eee 


HOLDING INTERRUPT IN A PROGRAM 

To enter the hold state again after validating the interrupt with an —ON 
statement during the interrupt processing routine, insert a —STOP 
statement. 


Program example 


10 ON KEY GOSUB 100 

20 KEY(1) ON 

30 SCREEN 2 

40 LINE (50,50)-(200,150),,B 
50 GOTO 40 

100 *SUBROUTINE 

105 KEY(1) ON 

110 BEEP:CLS 

120 FOR I=10 TO 90 STEP 10 
130 CIRCLE (120,100),1 

[135 IF I=50 THEN KEY(1) STOP 
140 NEXT I 

150 CLS 

160 RETURN 40 











This program is the same as the previous One. However, in this program, 
when the value of | becomes 50, KEY(1) STOP is executed in line 135. As 
a result, an [Ft | key interrupt occurs immediately during interrupt 
processing execution if it occurs before the 5th circle is drawn. However, 
an interrupt hold occurs after the 5th circle is drawn and an interrupt 
does not occur immediately when the [Ft | key is pressed. 


|+— interrupt processing routine | Peet processing 


Main program Beep Beep 





= ~ eine - 2 aes 








Press the [Ft] key before the Sth circle is drawn. 


|-—_> Interrupt processing routine 
Main program Beep Press the [Ft] key after the 5th circle is drawn. 


(HC 


Returns to the main program once. 





























Interrupt occurs here. 


ed Oo sf 





SPRITE OVERLAP INTERRUPT EXAMPLE 

When two or more sprite patterns overlap by 1 dot, an interrupt can be 
generated by an ON SPRITE GOSUB statement and SPRITE ON. 

In the following program, UFOs fly from left and right and a beep sound 
occurs when the UFOs overlap. 


10 SCREEN 2 

20 SPRITES (0) =CHRS (&H3C) +CHRS (&H7E) +CHRS 
(&H8 1) +CHRS (&H8 1) +CHRS (&HFF) +CHRS (&H7E) + 
CHR $ (&H24 ) +CHRS (&H4 2) 

30 ON SPRITE GOSUB 100 

40 SPRITE ON 

50 FOR X=0 TO 255 

60 PUT SPRITE 0, (X,100) ,15,0 

70 PUT SPRITE 1, (255-X,100) ,10,0 

80 NEXT X 

90 END 

100 SPRITE OFF 

110 BEEP 

120 SPRITE ON 

130 RETURN 


ats 


182 


2-8 MACHINE LANGUAGE 
SUBROUTINES 


With MSX-BASIC, a program can be written by using the machine lan- 
guage of Z-80A (the MSX personal computer CPU) to which control is 
transferred from BASIC, and the execution result of the machine lan- 
guage program can be given to a variable defined by BASIC. 


MACHINE LANGUAGE SUBROUTINE STARTING ADDRESS 
DEFINITION 

First Secure an area where the machine language subroutine is written 
by using a CLEAR statement. Then define the starting address of the 
subroutine by using a DEFUSR statement. 


DEFUSR N = Starting address 


N is an integer from 0 to 9. The starting address of 10 subroutines can 
be defined as a USR function. 


CLEAR 200 ,&HDFFF 
DEFUSR 1=&HEOOO 


With these statements, a machine language subroutine from address 
&HEOOO is defined as a USR 1 function. 


MACHINE LANGUAGE SUBROUTINE EXECUTION 

Variable=USR N(1) 
The defined machine language subroutine is executed by executing the 
above statement. When the machine language subroutine has been ex- 
ecuted, the value of the execution result is given to a variable, and the 


BASIC program is also continuously executed. 


When execution is transferred to a machine language subroutine, the 


value of “I specified as a USR function parameter is given to a 
subroutine. 
X=USR 1 (1) 


The value of variable lis stored at the following memory location by the 
above statement, and at the same time, data that indicates the type is 
entered to register A depending on the type of I. The starting address of 
the area where the value of | is stored is entered to the HL register. 



































Type of | Data input HL register | Address where the value 
toA address of | is stored. 
register” indication 

Integer type 2 &HF7F8— &HF7F9 

Single- 

precision 4 &HF7F6 &HF7F6E—&HF7F9 

type 

Double- 

precision 8 &HF7F6E—&HF7FD 

type 








*The same data is input to the &HF663 memory address. 


When | is a string type variable, the above mentioned is as follows. 

















stored. 


Data input Data input String descripter 
to A register | to DE 
register 
3 String ist byte: Length of character string 
descripter 2nd and 3rd bytes: 
starting Starting address of the area 
address where the character string is 








When execution of the machine language subroutine has been terminat- 
ed, the value of the result is given to variable X by setting the register and 


memory during termination. 



































Result value type} &HF633] DE register|HL register|Result storage 
memory address 
address 
Integer type 2 &HF7F6 |&HF7F8—&HF7F9 
Single-precision 4 &HF7F6 |&HF7F6E—&HF7F9 
type 
Double-precision 8 &HF7F6 |&HF7F6B—&HF7FD 
type 
String type 3 String Area start address 
descripter indicated by the 
starting 2nd and 3rd string 
address descripter byte. 
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MACHINE LANGUAGE PREPARATION 

A machine language subroufine is written to memory by using a POKE 
statement. 

A return from a machine language subroutine to the BASIC program is 
accomplished with a RET instruction. 








CHAPTER 3 
TABLES 
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1. CHARACTERS 


CHARACTERS HANDLED BY MSX-BASIC 


The characters shown in the following character code table can be dis- 




















played. 
Hexadecimal 00—1F2 20—3F 40—5F 60—7F 
code code |character |code |character |code |character |code |character 

0 0 (null) 32 | (space) | 64 @ 96 \ 
1 1 'S 33 65 A 97 a 
2 2 8 34 bs 66 B 98 b 
3 3 v 35 # 67 Cc 99 c 
4 4 ¢ 36 $ 68 D 100 d 
5 5 te 37 % 69 E 101 e 
6 6 4 38 & 70 F 102 f 
Z 7 : 39 ; 71 G 103 g 
8 8 | 40 ( 72 H 104 h 
9 9 © 41 ) 73 | 105 i 
A 10 | 42 oS 74 J 106 
B 11 rad 43 + 75 K 107 k 
C 12 Gg 44 ; 76 L 108 | 
D 13 ? 45 = 77 M 109 m 
E 14 4 46 : 78 N 110 n 
F 15 x 47 i 79 O 111 fo) 
0 16 48 0 80 P 112 p 
1 17 Lt 49 1 81 Q 113 q 
2 18 aT 50 2 82 R 114 r 
3 19 7 51 3 83 Ss 115 s 
4 20 | 52 4 84 ac 116 t 
5 21 53 5 85 U 117 u 
6 22 54 6 86 V 118 v 
7 23 — 55 7 87 Ww 119 w 
8 24 r 56 8 88 x 120 x 
9 25 7 57 9 89 Y 121 y 
A 26 is 58 90 z 122 z 
B 27 J 59 : 91 [ 123 { 
Cc 28 x 60 < 92 \ 124 
D 29 we 61 = 93 ] 125 } 
E 30 S 62 > 94 A 126 ~ 
F 31 + 63 ? 95 2 127 


















































Plewadeciraall.  80—9F AO—BF CO—DF EO EF 
code code |character |code [character |code |character |code [character 
anearaan Peer 

0 128 C 160 a 192 - 224 a 
1 129 ti 161 193)  |25] 26 
2 130 é 162 ) 194 i 226 r 
3 134 a 163 u 195 _ 227 ial 
4 132 a 164 Ai 196 7 228 > 
5 133 a 165 N 197 HB | 229 s 
6 134 a 166 a 198 j 230 ii 
7 135 ¢ 167 Q 199} gf | 231 * 
8 136 é 168 i 200 | 232 ’ 
9 137 é 169 Le 201 | 233 9 
A 138 é 170 a 202 | 234 Q 
B 139 i 171 I 203 ae 235 5 
@ 140 i 172 ‘le 204; 236 co 
D 144 i 173 205 Vv 237 D 
E 142 A 174 « 206 A 238 € 
F 143 A 175 > 207 » 239 n 
0 144 é 176] A | 208 q | 240] » 
1 145 | 2 | 177 a 209} J | 241 le 
2 146 z 178 i 210 AI 242 = 
3 147 6 179 7 211 1 243 < 
4 148 6 180 O 212 | 244 f 
5 149 6 184 6 213 245 J 
6 150 a 182 U 214 = 246 + 
7 151 u 183 a 215 = 247 = 
8 152 y 184 4 216 A 248 ° 
9 153 O 185 iJ 217 : 249 . 
A 154 U 186 fa 218 w 250 - 
B 155 ¢ 187 219 | ff | 251 ‘a 
Cc 156 £ 188 } 220 "] 252 . 
D 157 ¥ 189 ofeo 221 I 253 2 
E 158 Pt 190 T 222 I | 254 s 
F 159 Ff 191 § 223 a 255 | cerzor 
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Characters whose character code consists of 2 bytes 


Characters of codes 1 to 31 (decimal) in the above table have 2-byte 
character codes. Their codes in the table should be preceded by the code 
1 and the codes listed in the table should be added by 64 (decimal). 


Input/output of character codes 
Input from the keyboard 
Normal characters ..... 1-byte code is input. 
Example: Code 65 (decimal) for the 
character “A” 
2-byte code characters ..... 1 and the other code are input. 
Example: Code 1 and 67 for the 
character “9 
Output using CHR$ function 
Normal characters ..... 1-byte code is used as a parameter. 
Example: CHR$ (66) for the character “B” 
2-byte code characters ..... 2 CHR$ functions are used, of which the 
first one is CHR$(1), and the following 
one is a CHR$ function using the 
above listed code as a parameter. 
Example: CHR$(1); CHR$(68) for the 
character “@” 





2. CONSTANTS AND VARIABLES 


CONSTANTS 
Constants ... Always indicate a certain value. 


Constants handled by MSX-BASIC 
Numeric type constants Integer type Decimal expression 
[Fixed point Hexadecimal expression 
Floating point + Octal expression 
- Binary expression 
String type constants 


Numeric type constants 





Integer type Range from —32768 to 32767. 

Decimal expression: As it is (Example ... 123, — 4567) 
Hexadecimal expression: Add &H (Example ... &HAO) 
Octal expression: Add &O or & (Example &0146, &765) 
Binary expression: Add &B (Example ... &B11010110) 





Floating-point type | 6 (single precision) or 14 (double precision) significant 

digits. 

Exponent part From —64 to +62 (Radix of exponent 
is 10) 

(Example: 1.345E — 10) 











Single precision and double precision 
Either Fixed point type 
or 
Floating point type 


Single precision or double precision 
(Initial setting is double precision.) 








Single precision When E is used for a power symbol: 

(6 significant digits) Example: 12.34E3 

When ! is added at the back: 
Example: 18.32! 





Double precision When D is used as a power symbol: 

(14 significant digits) Example: 23.456789D10 

When nothing is added at the back: 
Example: 3456789012.34 

When # is added at the back: 
Example: 3456789012.34 # 

















String type constants 

Character string with up to 255 characters inside ‘“ ” (double quotation 
marks). 

String type constant that does not include a character or space ... Null 
String. 


“HOW ARE YOU?” 
”“@980” 
(null string) 


VARIABLES 


Variable names 

@ Only the first two characters are significant (the 1st character must be 
an alphabetical character). 

@ MSX-BASIC reserved words (command names, function names, etc.) or 
a character string that includes a reserved word cannot be used as a vari- 
able name. 


Type declaration 

















Declaration by a Declaration by a Type declared 
type declaration DEF statement 

character 

Add % DEFINT tnteger type 
Example: A% Example: DEFINT A 

Add ! DEFSNG Single precision 
Example: B! Example: DEFSNG B 

Add # DEFDBL Double precision 
Example: C# Example: DEFDBL C 

Add $ DEFSTR String type 
Example: D$ Example: DEFSTR D 

















@When a different type of type declaration character is placed for the 
variable name after the type declaration statement (DEFINT, etc) was ex- 
ecuted, the type declaration character has priority. 























Type conversion 











1.1428571428571 


Example Description 
When a constant other than the one 
A%=100.5 declared is assigned to a variable 
PRINT A% declared as an integer type, the 
100 assignment is performed according to 
the type of variable. 
B=8!/7! The arithmetic result is assigned with 
PRINT B 


double precision. 





B!=8/7 
PRINT B! 
1.14286 


Because a single precision type 
declaration character is placed ina 
variable, a single precision arithmetic 
result is assigned. 





PRINT 6.7 OR 4.3 
6 


The logical operation is performed 
after the data is converted to an 
integer. 





A!=1.2345678 
B=A! 

PRINT B 
1.23457 








When data that has only single 
precision digits is assigned toa 
double precision variable, the number 
of digits remain the same. 











3. EXPRESSIONS AND THEIR 
OPERATION 


PARTS-OF EXPRESSIONS 
Constants, variables, functions, and arithmetic symbols. 


EVALUATION OF ARITHMETIC EXPRESSIONS 












































Arithmetic operator Semantics Example Priority order 

fs Addition (X +Y) xay ‘ 
= Subtraction (X—Y) XY 
* Multiplication (X x Y) XY : 
/ Division (X= Y) XIY 
A Power (X?) XA2 1 
— Changes a sign (— X) —X 2 
\ Integer division 6.7\23 | 4 

woo [Remaintoot [x woo | 














RELATIONAL EXPRESSIONS 
The value of two data are compared and the result is given as true (— 1) 
or false. 






































Relational operator Semantics Example 
= Equal X=Y, X$=YS 
< Smaller X<yY, X$<Y$ 
> Larger X> Y, X$>Y$ 
BD JSS Not equal X<>Y, X$><Y$ 
c-cd Smaller or equal X<=Y, X$< =Y$ 
SSS > Larger or equal X>=Y, X$>=Y$ 














LOGICAL EXPRESSIONS 

Logical expressions perform logical operations between numeric type 

constants, variables, and functions. 

Logical operation ... Converts data to an integer considered as 16 bit 
binary, and performs an operation for each corresponding bit. 































































































Logical operation Logical operation result for each bit 

NOT (negation) ee 
1 0 

0 A= | 

AND (logical product) [x TY [X AND Y ] 
1]1 1 

1/0 =| 

lo [1 o | 
0|0 0 

OR (logical sum) [x Ty [x or Y 

1/1 i} 

140 1 i} 
OL pa) 
0/0 0 

XOR (exclusive OR) be hi ESL, 

1 [0 1 | 

FO) ten | 

lofo[ 0 | 

EQV (exclusive OR negation) bah X EQV Y | 
: 

Papo oe | 
0j1 0 

[o [o 1 | 

IMP (implication) [x]Y [X IMP Y ] 
Ae het ‘A 

1/0 Ors | 

0 {1 1 | 

010 1 | 





























CHARACTER EXPRESSIONS 
For operations between string type constants, variables and functions, 
only addition is effective. 


Example 


PRINT “ABC”+”XY2Z” 
ABCXYZ 





4. COLOR CODES 





























Code} Color Code| Color |Code| Color |Code| Color 
0 | Transparent ; 4  |Dark blue 8 |Medium red} 12 | Dark green 
1 |Black | 5 |Light blue} 9 | Light red 13 | Magenta 
2 |Medium green | 6 | Dark red 10 |Dark yellow] 14 | Gray 
3 | Light green | 7 |Sky blue | 11 |Light yellow] 15 | White 


























5. MEMORY MAP 


© Cee &H0000 BANK 4 


16 3kr ZHYOOOL--- MSX-BASIC ROM .- (BANK < 


6yT Kb 


32762 &H8000 GANKS 


User area 2 


bANK 4 When 64 K byte 


&HC000 RAM is installed 


User area 1 When 16 K byte 
RAM is installed 


Y w 


See the Operating Instructions for the RAM capacity. 


&HF380 





&HFFFF 


194 


USER AREA CONFIGURATION 


&H8000 
(&HCO000) 
Program area 


Variable area 
Array variable area 


&HF37F 





Program area 
A program is stored with line numbers. 


Variable area 
Stores numeric type data and pointers for string type data. 


Array variable area 
Stores array variable data. Stores the pointer for the character string area 
if it is a string type. 


Free area 
Unused area. The size can be known with the FRE function. 


Stack area 
The stack area is used to save a return address. 


Character string area 

Stores a character string included in a string type variable or array 
variable. 

The size can be specified with a CLEAR statement. 


File control block 
Used during file Input/Output. 





abs} 


6. I/O PORT ALLOCATION 





















































Utilization Port No. Application 
RS-232-C &H80 Data read-out/write-in 
&H81 Mode set (during write-in) 
Status (during read-out) 
Printer &H90 Strobe (during write-in) 
Status (during read-out) 
&H91 Data write-in 
VDP &H98 Data read-out/write-in with video RAM. 
&H99 Command, address set (during write-in) 
Status (during read-in) 
PSG &HAO Address latch (write-in) 
&HA1 Data write-in 
&HA2 Data read-out 
PPI &HA8 Data read-out/write-in for port A (Memory 
slot select) use. 
& HAY Data read-out/write-in for port B (key- 
board scan) use. 
&HAA Data read-out/write-in for port C (cassette). 
&HAB Mode set (write-in) 








@1/O addresses from &HOO to &H7F are not used. Addresses other than 
the above addresses of the address among &H80 to &HFF are reserved 
for system use. 


AN 
Hl 


Gas 
a 


es 
ye 
s oe 





